Compare commits
46 commits
flake_add_
...
master
Author | SHA1 | Date | |
---|---|---|---|
fd10167985 | |||
cb3fe622ae | |||
|
7e0c827703 | ||
|
972faaadd5 | ||
|
807b252331 | ||
|
bbdac4045d | ||
|
4beb2487ce | ||
|
b54fa37fae | ||
|
66294cf7f6 | ||
|
366520ebfd | ||
|
d27f162316 | ||
|
4b69958c95 | ||
|
5cfe6c3dbd | ||
|
bbdc12c569 | ||
|
afb3d403e1 | ||
|
418656ee9f | ||
|
0d367baa5b | ||
|
8cbb60e476 | ||
|
0880461134 | ||
|
8f4b81b512 | ||
|
ab4cbcd01a | ||
|
704b198f5a | ||
|
0eb4550a8f | ||
|
249acc9e0b | ||
|
5efd38c990 | ||
|
ad76fc1570 | ||
|
b5d68376b5 | ||
|
dbd8a44fa2 | ||
|
722f4df4aa | ||
|
6d767aaf29 | ||
|
21e84095e6 | ||
|
464e193dad | ||
|
df2cfcb6d0 | ||
|
ed94b56d16 | ||
|
f52d179c18 | ||
|
85c0be5fbc | ||
|
203083cdd4 | ||
|
983e78dc53 | ||
|
92769cec71 | ||
|
d18d12d379 | ||
|
14c5ea70d4 | ||
|
ee1b0c8a9a | ||
|
84807125c0 | ||
|
eb21951124 | ||
|
39252b012b | ||
|
86a3d95855 |
53 changed files with 649 additions and 425 deletions
3
.gitignore
vendored
3
.gitignore
vendored
|
@ -38,3 +38,6 @@ xcuserdata/
|
||||||
*.dSYM
|
*.dSYM
|
||||||
Pods/
|
Pods/
|
||||||
*.xcworkspace
|
*.xcworkspace
|
||||||
|
|
||||||
|
# JetBrains tools
|
||||||
|
.idea/
|
||||||
|
|
|
@ -1,3 +1,56 @@
|
||||||
|
Changes in `3.2.16 <https://gitlab.matrix.org/matrix-org/olm/tags/3.2.16>`_
|
||||||
|
===========================================================================
|
||||||
|
|
||||||
|
This release includes the following changes since 3.2.15:
|
||||||
|
|
||||||
|
* Fix and modernize the Python packaging (thanks to Alfred Wingate)
|
||||||
|
|
||||||
|
Changes in `3.2.15 <https://gitlab.matrix.org/matrix-org/olm/tags/3.2.15>`_
|
||||||
|
===========================================================================
|
||||||
|
|
||||||
|
This release includes the following changes since 3.2.14:
|
||||||
|
|
||||||
|
* Improvements to Python packaging
|
||||||
|
* No longer depend on ``future`` since Python 2 is no longer supported.
|
||||||
|
* Improve compatibility with tox 4.
|
||||||
|
* Add support for making standalone sdist.
|
||||||
|
* Improvements to Nix flake (Thanks to Jon Ringer)
|
||||||
|
* Improve structure.
|
||||||
|
* Enable Darwin builds.
|
||||||
|
* Typescript type fix.
|
||||||
|
|
||||||
|
Changes in `3.2.14 <https://gitlab.matrix.org/matrix-org/olm/tags/3.2.14>`_
|
||||||
|
===========================================================================
|
||||||
|
|
||||||
|
This release includes the following changes since 3.2.13:
|
||||||
|
|
||||||
|
* TypeScript type improvements.
|
||||||
|
* Improvements to Python packaging
|
||||||
|
* Documentation improvements.
|
||||||
|
|
||||||
|
Changes in `3.2.13 <https://gitlab.matrix.org/matrix-org/olm/tags/3.2.13>`_
|
||||||
|
===========================================================================
|
||||||
|
|
||||||
|
This release includes the following changes since 3.2.12:
|
||||||
|
|
||||||
|
* Fix compilation with newer versions of emscripten.
|
||||||
|
* The npm package is compiled with emscripten 3.1.17 to fix compatibility with
|
||||||
|
node 18.
|
||||||
|
* Add py.typed to Python wheels.
|
||||||
|
* Some documentation fixes and updates.
|
||||||
|
* Improve the pkgconfig file.
|
||||||
|
|
||||||
|
Changes in `3.2.12 <https://gitlab.matrix.org/matrix-org/olm/tags/3.2.12>`_
|
||||||
|
===========================================================================
|
||||||
|
|
||||||
|
This release includes the following changes since 3.2.11:
|
||||||
|
|
||||||
|
* Expose olm_sas_calculate_mac_fixed_base64 in the bindings.
|
||||||
|
* Allow memory to grow in wasm. Thanks to benkuly for the suggestion.
|
||||||
|
* Fix Python type hints.
|
||||||
|
* Some Python build fixes.
|
||||||
|
* Initial work on a Nix flake for building and testing.
|
||||||
|
|
||||||
Changes in `3.2.11 <https://gitlab.matrix.org/matrix-org/olm/tags/3.2.11>`_
|
Changes in `3.2.11 <https://gitlab.matrix.org/matrix-org/olm/tags/3.2.11>`_
|
||||||
===========================================================================
|
===========================================================================
|
||||||
|
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
cmake_minimum_required(VERSION 3.4)
|
cmake_minimum_required(VERSION 3.4)
|
||||||
|
|
||||||
project(olm VERSION 3.2.11 LANGUAGES CXX C)
|
project(olm VERSION 3.2.16 LANGUAGES CXX C)
|
||||||
|
|
||||||
option(OLM_TESTS "Build tests" ON)
|
option(OLM_TESTS "Build tests" ON)
|
||||||
option(BUILD_SHARED_LIBS "Build as a shared library" ON)
|
option(BUILD_SHARED_LIBS "Build as a shared library" ON)
|
||||||
|
|
7
Makefile
7
Makefile
|
@ -8,7 +8,6 @@ RELEASE_OPTIMIZE_FLAGS ?= -O3
|
||||||
DEBUG_OPTIMIZE_FLAGS ?= -g -O0 -U_FORTIFY_SOURCE
|
DEBUG_OPTIMIZE_FLAGS ?= -g -O0 -U_FORTIFY_SOURCE
|
||||||
JS_OPTIMIZE_FLAGS ?= -O3
|
JS_OPTIMIZE_FLAGS ?= -O3
|
||||||
FUZZER_OPTIMIZE_FLAGS ?= -O3
|
FUZZER_OPTIMIZE_FLAGS ?= -O3
|
||||||
CC = gcc
|
|
||||||
EMCC = emcc
|
EMCC = emcc
|
||||||
EMAR = emar
|
EMAR = emar
|
||||||
AR = ar
|
AR = ar
|
||||||
|
@ -31,7 +30,7 @@ JS_ASMJS_TARGET := javascript/olm_legacy.js
|
||||||
WASM_TARGET := $(BUILD_DIR)/wasm/libolm.a
|
WASM_TARGET := $(BUILD_DIR)/wasm/libolm.a
|
||||||
|
|
||||||
JS_EXPORTED_FUNCTIONS := javascript/exported_functions.json
|
JS_EXPORTED_FUNCTIONS := javascript/exported_functions.json
|
||||||
JS_EXPORTED_RUNTIME_METHODS := [ALLOC_STACK]
|
JS_EXPORTED_RUNTIME_METHODS := [ALLOC_STACK,writeAsciiToMemory,intArrayFromString,UTF8ToString,stringToUTF8]
|
||||||
JS_EXTERNS := javascript/externs.js
|
JS_EXTERNS := javascript/externs.js
|
||||||
|
|
||||||
PUBLIC_HEADERS := include/olm/olm.h include/olm/outbound_group_session.h include/olm/inbound_group_session.h include/olm/pk.h include/olm/sas.h include/olm/error.h include/olm/olm_export.h
|
PUBLIC_HEADERS := include/olm/olm.h include/olm/outbound_group_session.h include/olm/inbound_group_session.h include/olm/pk.h include/olm/sas.h include/olm/error.h include/olm/olm_export.h
|
||||||
|
@ -94,7 +93,7 @@ LDFLAGS += -Wall -Werror
|
||||||
CFLAGS_NATIVE = -fPIC
|
CFLAGS_NATIVE = -fPIC
|
||||||
CXXFLAGS_NATIVE = -fPIC
|
CXXFLAGS_NATIVE = -fPIC
|
||||||
|
|
||||||
EMCCFLAGS = --closure 1 --memory-init-file 0 -s NO_FILESYSTEM=1 -s INVOKE_RUN=0 -s MODULARIZE=1
|
EMCCFLAGS = --closure 1 --memory-init-file 0 -s NO_FILESYSTEM=1 -s INVOKE_RUN=0 -s MODULARIZE=1 -Wno-error=closure
|
||||||
|
|
||||||
# Olm generally doesn't need a lot of memory to encrypt / decrypt its usual
|
# Olm generally doesn't need a lot of memory to encrypt / decrypt its usual
|
||||||
# payloads (ie. Matrix messages), but we do need about 128K of heap to encrypt
|
# payloads (ie. Matrix messages), but we do need about 128K of heap to encrypt
|
||||||
|
@ -104,7 +103,7 @@ EMCCFLAGS = --closure 1 --memory-init-file 0 -s NO_FILESYSTEM=1 -s INVOKE_RUN=0
|
||||||
# (This can't be changed by the app with wasm since it's baked into the wasm).
|
# (This can't be changed by the app with wasm since it's baked into the wasm).
|
||||||
# (emscripten also mandates at least 16MB of memory for asm.js now, so
|
# (emscripten also mandates at least 16MB of memory for asm.js now, so
|
||||||
# we don't use this for the legacy build.)
|
# we don't use this for the legacy build.)
|
||||||
EMCCFLAGS_WASM += -s TOTAL_STACK=65536 -s TOTAL_MEMORY=262144
|
EMCCFLAGS_WASM += -s TOTAL_STACK=65536 -s TOTAL_MEMORY=262144 -s ALLOW_MEMORY_GROWTH
|
||||||
|
|
||||||
EMCCFLAGS_ASMJS += -s WASM=0
|
EMCCFLAGS_ASMJS += -s WASM=0
|
||||||
|
|
||||||
|
|
|
@ -3,7 +3,7 @@ Pod::Spec.new do |s|
|
||||||
# The libolm version
|
# The libolm version
|
||||||
MAJOR = 3
|
MAJOR = 3
|
||||||
MINOR = 2
|
MINOR = 2
|
||||||
PATCH = 11
|
PATCH = 16
|
||||||
|
|
||||||
s.name = "OLMKit"
|
s.name = "OLMKit"
|
||||||
s.version = "#{MAJOR}.#{MINOR}.#{PATCH}"
|
s.version = "#{MAJOR}.#{MINOR}.#{PATCH}"
|
||||||
|
|
|
@ -2,7 +2,7 @@
|
||||||
|
|
||||||
import PackageDescription
|
import PackageDescription
|
||||||
|
|
||||||
let major = 3, minor = 2, patch = 11
|
let major = 3, minor = 2, patch = 16
|
||||||
|
|
||||||
let package = Package(
|
let package = Package(
|
||||||
name: "Olm",
|
name: "Olm",
|
||||||
|
|
96
README.md
96
README.md
|
@ -9,6 +9,69 @@ The specification of the Olm ratchet can be found in [docs/olm.md](docs/olm.md).
|
||||||
This library also includes an implementation of the Megolm cryptographic
|
This library also includes an implementation of the Megolm cryptographic
|
||||||
ratchet, as specified in [docs/megolm.md](docs/megolm.md).
|
ratchet, as specified in [docs/megolm.md](docs/megolm.md).
|
||||||
|
|
||||||
|
## Installing
|
||||||
|
|
||||||
|
### Linux and other Unix-like systems
|
||||||
|
|
||||||
|
Your distribution may have pre-compiled packages available. If not, or if you
|
||||||
|
need a newer version, you will need to compile from source. See the "Building"
|
||||||
|
section below for more details.
|
||||||
|
|
||||||
|
### macOS
|
||||||
|
|
||||||
|
The easiest way to install on macOS is via Homebrew. If you do not have
|
||||||
|
Homebrew installed, follow the instructions at https://brew.sh/ to install it.
|
||||||
|
|
||||||
|
You can then install libolm by running
|
||||||
|
|
||||||
|
```bash
|
||||||
|
brew install libolm
|
||||||
|
```
|
||||||
|
|
||||||
|
If you also need the Python packages, you can run
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pip3 install python-olm --global-option="build_ext" --global-option="--include-dirs="`brew --prefix libolm`"/include" --global-option="--library-dirs="`brew --prefix libolm`"/lib"
|
||||||
|
```
|
||||||
|
|
||||||
|
Note that this will install an older version of the Python bindings, which may
|
||||||
|
be missing some functions. If you need the latest version, you will need to
|
||||||
|
build from source.
|
||||||
|
|
||||||
|
### Windows
|
||||||
|
|
||||||
|
You will need to build from source. See the "Building" section below for more
|
||||||
|
details.
|
||||||
|
|
||||||
|
### Bindings
|
||||||
|
|
||||||
|
#### JavaScript
|
||||||
|
|
||||||
|
You can use pre-built npm packages, available at
|
||||||
|
<https://gitlab.matrix.org/matrix-org/olm/-/packages?type=npm>.
|
||||||
|
|
||||||
|
#### Python
|
||||||
|
|
||||||
|
A Python source package and pre-built packages for certain architectures from
|
||||||
|
<https://pypi.org/project/python-olm/>. If a pre-built package is not
|
||||||
|
available for your architecture, you will need:
|
||||||
|
|
||||||
|
- cmake (recommended) or GNU make
|
||||||
|
- a C/C++ compiler
|
||||||
|
|
||||||
|
to build the source package.
|
||||||
|
|
||||||
|
You can then run `pip install python-olm`.
|
||||||
|
|
||||||
|
Currently, we try to provide packages for all supported versions of Python on
|
||||||
|
x86-64, i686, and aarch64, but we cannot guarantee that packages for all
|
||||||
|
versions will be available on all architectures.
|
||||||
|
|
||||||
|
#### Android
|
||||||
|
|
||||||
|
Pre-built Android bindings are available at
|
||||||
|
<https://gitlab.matrix.org/matrix-org/olm/-/packages?type=Maven>.
|
||||||
|
|
||||||
## Building
|
## Building
|
||||||
|
|
||||||
To build olm as a shared library run:
|
To build olm as a shared library run:
|
||||||
|
@ -41,22 +104,38 @@ target_link_libraries(my_exe Olm::Olm)
|
||||||
|
|
||||||
### Bindings
|
### Bindings
|
||||||
|
|
||||||
To build the JavaScript bindings, install emscripten from https://emscripten.org/ and then run:
|
#### JavaScript
|
||||||
|
|
||||||
|
The recommended way to build the JavaScript bindings is using
|
||||||
|
[Nix](https://nixos.org/). With Nix, you can run
|
||||||
|
|
||||||
|
```bash
|
||||||
|
nix build .\#javascript
|
||||||
|
```
|
||||||
|
|
||||||
|
to build the bindings.
|
||||||
|
|
||||||
|
If you do not have Nix you can, install emscripten from https://emscripten.org/
|
||||||
|
and then run:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
make js
|
make js
|
||||||
```
|
```
|
||||||
|
|
||||||
Note that if you run emscripten in a docker container, you need to pass through
|
Emscripten can also be run via Docker, in which case, you need to pass through
|
||||||
the EMCC_CLOSURE_ARGS environment variable.
|
the EMCC_CLOSURE_ARGS environment variable.
|
||||||
|
|
||||||
|
#### Android
|
||||||
|
|
||||||
To build the android project for Android bindings, run:
|
To build the android project for Android bindings, run:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cd android
|
cd android
|
||||||
./gradlew clean assembleRelease
|
./gradlew clean build
|
||||||
```
|
```
|
||||||
|
|
||||||
|
#### Objective-C
|
||||||
|
|
||||||
To build the Xcode workspace for Objective-C bindings, run:
|
To build the Xcode workspace for Objective-C bindings, run:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
|
@ -65,7 +144,9 @@ pod install
|
||||||
open OLMKit.xcworkspace
|
open OLMKit.xcworkspace
|
||||||
```
|
```
|
||||||
|
|
||||||
To build the Python bindings, first build olm as a shared library as above, and
|
#### Python
|
||||||
|
|
||||||
|
To build the Python 3 bindings, first build olm as a library as above, and
|
||||||
then run:
|
then run:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
|
@ -73,9 +154,6 @@ cd python
|
||||||
make
|
make
|
||||||
```
|
```
|
||||||
|
|
||||||
to make both the Python 2 and Python 3 bindings. To make only one version, use
|
|
||||||
``make olm-python2`` or ``make olm-python3`` instead of just ``make``.
|
|
||||||
|
|
||||||
### Using make instead of cmake
|
### Using make instead of cmake
|
||||||
|
|
||||||
**WARNING:** Using cmake is the preferred method for building the olm library;
|
**WARNING:** Using cmake is the preferred method for building the olm library;
|
||||||
|
@ -119,7 +197,7 @@ repository, some bindings are (in alphabetical order):
|
||||||
- [nim-olm](https://codeberg.org/BarrOff/nim-olm) (MIT) Nim bindings
|
- [nim-olm](https://codeberg.org/BarrOff/nim-olm) (MIT) Nim bindings
|
||||||
- [olm-sys](https://gitlab.gnome.org/BrainBlasted/olm-sys) (Apache-2.0) Rust
|
- [olm-sys](https://gitlab.gnome.org/BrainBlasted/olm-sys) (Apache-2.0) Rust
|
||||||
bindings
|
bindings
|
||||||
- [Trixnity](https://gitlab.com/benkuly/trixnity) (AGPLv3) Kotlin SDK for
|
- [Trixnity](https://gitlab.com/trixnity/trixnity) (Apache-2.0) Kotlin SDK for
|
||||||
Matrix, including Olm bindings
|
Matrix, including Olm bindings
|
||||||
|
|
||||||
Note that bindings may have a different license from libolm, and are *not*
|
Note that bindings may have a different license from libolm, and are *not*
|
||||||
|
@ -128,7 +206,7 @@ endorsed by the Matrix.org Foundation C.I.C.
|
||||||
## Release process
|
## Release process
|
||||||
|
|
||||||
First: bump version numbers in ``common.mk``, ``CMakeLists.txt``,
|
First: bump version numbers in ``common.mk``, ``CMakeLists.txt``,
|
||||||
``javascript/package.json``, ``python/olm/__version__.py``, ``OLMKit.podspec``,
|
``javascript/package.json``, ``python/pyproject.toml``, ``OLMKit.podspec``,
|
||||||
``Package.swift``, and ``android/gradle.properties``.
|
``Package.swift``, and ``android/gradle.properties``.
|
||||||
|
|
||||||
Also, ensure the changelog is up to date, and that everything is committed to
|
Also, ensure the changelog is up to date, and that everything is committed to
|
||||||
|
|
|
@ -11,8 +11,8 @@
|
||||||
SET(CMAKE_SYSTEM_NAME Windows)
|
SET(CMAKE_SYSTEM_NAME Windows)
|
||||||
|
|
||||||
# which compilers to use for C and C++
|
# which compilers to use for C and C++
|
||||||
SET(CMAKE_C_COMPILER x86_64-w64-mingw32-gcc)
|
SET(CMAKE_C_COMPILER x86_64-w64-mingw32-gcc-posix)
|
||||||
SET(CMAKE_CXX_COMPILER x86_64-w64-mingw32-g++)
|
SET(CMAKE_CXX_COMPILER x86_64-w64-mingw32-g++-posix)
|
||||||
SET(CMAKE_RC_COMPILER x86_64-w64-mingw32-windres)
|
SET(CMAKE_RC_COMPILER x86_64-w64-mingw32-windres)
|
||||||
|
|
||||||
# here is the target environment located
|
# here is the target environment located
|
||||||
|
|
|
@ -26,7 +26,7 @@ org.gradle.configureondemand=false
|
||||||
# Ref: https://github.com/vanniktech/gradle-maven-publish-plugin
|
# Ref: https://github.com/vanniktech/gradle-maven-publish-plugin
|
||||||
GROUP=org.matrix.android
|
GROUP=org.matrix.android
|
||||||
POM_ARTIFACT_ID=olm
|
POM_ARTIFACT_ID=olm
|
||||||
VERSION_NAME=3.2.11
|
VERSION_NAME=3.2.16
|
||||||
|
|
||||||
POM_PACKAGING=aar
|
POM_PACKAGING=aar
|
||||||
|
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
|
|
||||||
MAJOR := 3
|
MAJOR := 3
|
||||||
MINOR := 2
|
MINOR := 2
|
||||||
PATCH := 11
|
PATCH := 16
|
||||||
|
|
|
@ -109,7 +109,7 @@ discriminate between sessions.
|
||||||
### Sharing session data
|
### Sharing session data
|
||||||
|
|
||||||
To allow other participants in the conversation to decrypt messages, the
|
To allow other participants in the conversation to decrypt messages, the
|
||||||
session data is formatted as described in [Session-sharing format](#Session-sharing-format). It is then
|
session data is formatted as described in [Session-sharing format](#session-sharing-format). It is then
|
||||||
shared with other participants in the conversation via a secure peer-to-peer
|
shared with other participants in the conversation via a secure peer-to-peer
|
||||||
channel (such as that provided by [Olm][]).
|
channel (such as that provided by [Olm][]).
|
||||||
|
|
||||||
|
@ -182,9 +182,13 @@ but the decision of which ratchet states to cache is left to the application.
|
||||||
|
|
||||||
## Data exchange formats
|
## Data exchange formats
|
||||||
|
|
||||||
### Session-sharing format
|
### Session sharing format
|
||||||
|
|
||||||
The Megolm key-sharing format is as follows:
|
This format is used for the initial sharing of a Megolm session with other
|
||||||
|
group participants who need to be able to read messages encrypted by this
|
||||||
|
session.
|
||||||
|
|
||||||
|
The session sharing format is as follows:
|
||||||
|
|
||||||
```
|
```
|
||||||
+---+----+--------+--------+--------+--------+------+-----------+
|
+---+----+--------+--------+--------+--------+------+-----------+
|
||||||
|
@ -202,6 +206,33 @@ part of the Ed25519 keypair $`K`$.
|
||||||
The data is then signed using the Ed25519 keypair, and the 64-byte signature is
|
The data is then signed using the Ed25519 keypair, and the 64-byte signature is
|
||||||
appended.
|
appended.
|
||||||
|
|
||||||
|
### Session export format
|
||||||
|
|
||||||
|
Once the session is initially shared with the group participants, each
|
||||||
|
participant needs to retain a copy of the session if they want to maintain
|
||||||
|
their ability to decrypt messages encrypted with that session.
|
||||||
|
|
||||||
|
For forward-secrecy purposes, a participant may choose to store a ratcheted
|
||||||
|
version of the session. But since the ratchet index is covered by the
|
||||||
|
signature, this would invalidate the signature. So we define a similar format,
|
||||||
|
called the *session export format*, which is identical to the [session sharing
|
||||||
|
format](#session-sharing-format) except for dropping the signature.
|
||||||
|
|
||||||
|
The Megolm session export format is thus as follows:
|
||||||
|
|
||||||
|
```
|
||||||
|
+---+----+--------+--------+--------+--------+------+
|
||||||
|
| V | i | R(i,0) | R(i,1) | R(i,2) | R(i,3) | Kpub |
|
||||||
|
+---+----+--------+--------+--------+--------+------+
|
||||||
|
0 1 5 37 69 101 133 165 bytes
|
||||||
|
```
|
||||||
|
|
||||||
|
The version byte, ``V``, is ``"\x01"``.
|
||||||
|
|
||||||
|
This is followed by the ratchet index, $`i`$, which is encoded as a
|
||||||
|
big-endian 32-bit integer; the ratchet values $`R_{i,j}`$; and the public
|
||||||
|
part of the Ed25519 keypair $`K`$.
|
||||||
|
|
||||||
### Message format
|
### Message format
|
||||||
|
|
||||||
Megolm messages consist of a one byte version, followed by a variable length
|
Megolm messages consist of a one byte version, followed by a variable length
|
||||||
|
|
18
flake.lock
18
flake.lock
|
@ -2,11 +2,11 @@
|
||||||
"nodes": {
|
"nodes": {
|
||||||
"flake-utils": {
|
"flake-utils": {
|
||||||
"locked": {
|
"locked": {
|
||||||
"lastModified": 1649676176,
|
"lastModified": 1659877975,
|
||||||
"narHash": "sha256-OWKJratjt2RW151VUlJPRALb7OU2S5s+f0vLj4o1bHM=",
|
"narHash": "sha256-zllb8aq3YO3h8B/U0/J1WBgAL8EX5yWf5pMj3G0NAmc=",
|
||||||
"owner": "numtide",
|
"owner": "numtide",
|
||||||
"repo": "flake-utils",
|
"repo": "flake-utils",
|
||||||
"rev": "a4b154ebbdc88c8498a5c7b01589addc9e9cb678",
|
"rev": "c0e246b9b83f637f4681389ecabcb2681b4f3af0",
|
||||||
"type": "github"
|
"type": "github"
|
||||||
},
|
},
|
||||||
"original": {
|
"original": {
|
||||||
|
@ -17,11 +17,11 @@
|
||||||
},
|
},
|
||||||
"nixpkgs": {
|
"nixpkgs": {
|
||||||
"locked": {
|
"locked": {
|
||||||
"lastModified": 1652172129,
|
"lastModified": 1664871473,
|
||||||
"narHash": "sha256-8e2JMrswaKe02P8rYfvIMoc59pNuw6h/GYu8DBE1c+0=",
|
"narHash": "sha256-1LzbW6G6Uz8akWiOdlIi435GAm1ct5jF5tovw/9to0o=",
|
||||||
"owner": "NixOS",
|
"owner": "NixOS",
|
||||||
"repo": "nixpkgs",
|
"repo": "nixpkgs",
|
||||||
"rev": "f419dc5763c2b3c5580e396dea065b6d8b58ee27",
|
"rev": "b7a6fde153d9470afdb6aa1da51c4117f03b84ed",
|
||||||
"type": "github"
|
"type": "github"
|
||||||
},
|
},
|
||||||
"original": {
|
"original": {
|
||||||
|
@ -34,11 +34,11 @@
|
||||||
"npmlock2nix": {
|
"npmlock2nix": {
|
||||||
"flake": false,
|
"flake": false,
|
||||||
"locked": {
|
"locked": {
|
||||||
"lastModified": 1648735462,
|
"lastModified": 1654775747,
|
||||||
"narHash": "sha256-G22WBttdFoWp7E/YvGfePOc+W+ZsQGw+IwpFbAwJNeI=",
|
"narHash": "sha256-9pXHDpIjmsK5390wmpGHu9aA4QOPpegPBvThHeBlef4=",
|
||||||
"owner": "nix-community",
|
"owner": "nix-community",
|
||||||
"repo": "npmlock2nix",
|
"repo": "npmlock2nix",
|
||||||
"rev": "dd2897c3a6e404446704a63f40b9a29fa0acf752",
|
"rev": "5c4f247688fc91d665df65f71c81e0726621aaa8",
|
||||||
"type": "github"
|
"type": "github"
|
||||||
},
|
},
|
||||||
"original": {
|
"original": {
|
||||||
|
|
144
flake.nix
144
flake.nix
|
@ -3,7 +3,7 @@
|
||||||
|
|
||||||
inputs.nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
|
inputs.nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
|
||||||
# We can't use the current stable release because of
|
# We can't use the current stable release because of
|
||||||
# https://github.com/emscripten-core/emscripten/issues/14995
|
# https://github.com/emscripten-core/emscripten/issues/16913
|
||||||
inputs.flake-utils.url = "github:numtide/flake-utils";
|
inputs.flake-utils.url = "github:numtide/flake-utils";
|
||||||
inputs.npmlock2nix = {
|
inputs.npmlock2nix = {
|
||||||
url = "github:nix-community/npmlock2nix";
|
url = "github:nix-community/npmlock2nix";
|
||||||
|
@ -11,126 +11,30 @@
|
||||||
};
|
};
|
||||||
|
|
||||||
outputs = { self, nixpkgs, flake-utils, npmlock2nix }:
|
outputs = { self, nixpkgs, flake-utils, npmlock2nix }:
|
||||||
(
|
let
|
||||||
|
localOverlay = import ./nix/overlay.nix;
|
||||||
|
pkgsForSystem = system: import nixpkgs {
|
||||||
|
inherit system;
|
||||||
|
overlays = [
|
||||||
|
(final: prev: {
|
||||||
|
npmlock2nix = final.callPackage npmlock2nix {};
|
||||||
|
node_modules = final.npmlock2nix.node_modules { src = ./javascript; };
|
||||||
|
})
|
||||||
|
localOverlay
|
||||||
|
];
|
||||||
|
};
|
||||||
|
in (
|
||||||
# some systems cause issues, e.g. i686-linux is unsupported by gradle,
|
# some systems cause issues, e.g. i686-linux is unsupported by gradle,
|
||||||
# which causes "nix flake check" to fail. Investigate more later, but for
|
# which causes "nix flake check" to fail. Investigate more later, but for
|
||||||
# now, we will just allow x86_64-linux
|
# now, we will just allow x86_64-linux
|
||||||
flake-utils.lib.eachSystem [ "x86_64-linux" ] (system:
|
flake-utils.lib.eachSystem [ "x86_64-linux" "x86_64-darwin" "aarch64-darwin" ] (system: rec {
|
||||||
let
|
legacyPackages = pkgsForSystem system;
|
||||||
pkgs = import nixpkgs {
|
checks = {
|
||||||
inherit system;
|
inherit (legacyPackages) olm-gcc-cmake olm-clang-cmake olm-gcc-make;
|
||||||
overlays = [
|
};
|
||||||
(final: prev: {
|
packages = {
|
||||||
npmlock2nix = final.callPackage npmlock2nix {};
|
javascript = legacyPackages.olm-javascript;
|
||||||
})
|
};
|
||||||
];
|
}
|
||||||
};
|
));
|
||||||
node_modules = pkgs.npmlock2nix.node_modules { src = ./javascript; };
|
|
||||||
in
|
|
||||||
rec {
|
|
||||||
checks.gcc-cmake = pkgs.gccStdenv.mkDerivation {
|
|
||||||
name = "olm";
|
|
||||||
|
|
||||||
buildInputs = [ pkgs.cmake ];
|
|
||||||
|
|
||||||
src = ./.;
|
|
||||||
|
|
||||||
buildPhase = ''
|
|
||||||
cmake . -Bbuild
|
|
||||||
cmake --build build
|
|
||||||
'';
|
|
||||||
|
|
||||||
doCheck = true;
|
|
||||||
checkPhase = ''
|
|
||||||
cd build/tests
|
|
||||||
ctest .
|
|
||||||
cd ../..
|
|
||||||
'';
|
|
||||||
};
|
|
||||||
|
|
||||||
checks.clang-cmake = pkgs.clangStdenv.mkDerivation {
|
|
||||||
name = "olm";
|
|
||||||
|
|
||||||
buildInputs = [ pkgs.cmake ];
|
|
||||||
|
|
||||||
src = ./.;
|
|
||||||
|
|
||||||
buildPhase = ''
|
|
||||||
cmake . -Bbuild
|
|
||||||
cmake --build build
|
|
||||||
'';
|
|
||||||
|
|
||||||
doCheck = true;
|
|
||||||
checkPhase = ''
|
|
||||||
cd build/tests
|
|
||||||
ctest .
|
|
||||||
cd ../..
|
|
||||||
'';
|
|
||||||
};
|
|
||||||
|
|
||||||
checks.gcc-make = pkgs.gccStdenv.mkDerivation {
|
|
||||||
name = "olm";
|
|
||||||
|
|
||||||
src = ./.;
|
|
||||||
|
|
||||||
buildPhase = ''
|
|
||||||
make
|
|
||||||
'';
|
|
||||||
|
|
||||||
doCheck = true;
|
|
||||||
checkPhase = ''
|
|
||||||
make test
|
|
||||||
'';
|
|
||||||
|
|
||||||
installPhase = ''
|
|
||||||
make install PREFIX=$out
|
|
||||||
'';
|
|
||||||
};
|
|
||||||
|
|
||||||
packages.javascript = pkgs.buildEmscriptenPackage {
|
|
||||||
pname = "olm";
|
|
||||||
inherit (builtins.fromJSON (builtins.readFile ./javascript/package.json)) version;
|
|
||||||
|
|
||||||
buildInputs = with pkgs; [ gnumake python3 nodejs ];
|
|
||||||
|
|
||||||
src = ./.;
|
|
||||||
|
|
||||||
postPatch = ''
|
|
||||||
patchShebangs .
|
|
||||||
'';
|
|
||||||
|
|
||||||
configurePhase = "";
|
|
||||||
|
|
||||||
buildPhase = ''
|
|
||||||
export EM_CACHE=$TMPDIR
|
|
||||||
make javascript/exported_functions.json
|
|
||||||
make js
|
|
||||||
'';
|
|
||||||
|
|
||||||
output = [ "out" ];
|
|
||||||
|
|
||||||
installPhase = ''
|
|
||||||
mkdir -p $out/javascript
|
|
||||||
cd javascript
|
|
||||||
echo sha256: > checksums.txt
|
|
||||||
sha256sum olm.js olm_legacy.js olm.wasm >> checksums.txt
|
|
||||||
echo sha512: >> checksums.txt
|
|
||||||
sha512sum olm.js olm_legacy.js olm.wasm >> checksums.txt
|
|
||||||
cp package.json olm.js olm.wasm olm_legacy.js index.d.ts README.md checksums.txt $out/javascript
|
|
||||||
cd ..
|
|
||||||
'';
|
|
||||||
|
|
||||||
checkPhase = ''
|
|
||||||
cd javascript
|
|
||||||
export HOME=$TMPDIR
|
|
||||||
ln -s ${node_modules}/node_modules ./node_modules
|
|
||||||
npm test
|
|
||||||
cd ..
|
|
||||||
'';
|
|
||||||
};
|
|
||||||
|
|
||||||
packages.default = packages.javascript;
|
|
||||||
}
|
|
||||||
)
|
|
||||||
);
|
|
||||||
}
|
}
|
||||||
|
|
|
@ -99,9 +99,9 @@ public:
|
||||||
return *this;
|
return *this;
|
||||||
}
|
}
|
||||||
T * this_pos = _data;
|
T * this_pos = _data;
|
||||||
T * const other_pos = other._data;
|
const T * other_pos = other._data;
|
||||||
while (other_pos != other._end) {
|
while (other_pos != other._end) {
|
||||||
*this_pos = *other;
|
*this_pos = *other_pos;
|
||||||
++this_pos;
|
++this_pos;
|
||||||
++other_pos;
|
++other_pos;
|
||||||
}
|
}
|
||||||
|
|
|
@ -9,15 +9,15 @@
|
||||||
# ifndef OLM_EXPORT
|
# ifndef OLM_EXPORT
|
||||||
# ifdef olm_EXPORTS
|
# ifdef olm_EXPORTS
|
||||||
/* We are building this library */
|
/* We are building this library */
|
||||||
# define OLM_EXPORT __attribute__((visibility("default")))
|
# define OLM_EXPORT
|
||||||
# else
|
# else
|
||||||
/* We are using this library */
|
/* We are using this library */
|
||||||
# define OLM_EXPORT __attribute__((visibility("default")))
|
# define OLM_EXPORT
|
||||||
# endif
|
# endif
|
||||||
# endif
|
# endif
|
||||||
|
|
||||||
# ifndef OLM_NO_EXPORT
|
# ifndef OLM_NO_EXPORT
|
||||||
# define OLM_NO_EXPORT __attribute__((visibility("hidden")))
|
# define OLM_NO_EXPORT
|
||||||
# endif
|
# endif
|
||||||
#endif
|
#endif
|
||||||
|
|
||||||
|
|
36
javascript/index.d.ts
vendored
36
javascript/index.d.ts
vendored
|
@ -18,28 +18,28 @@ export as namespace Olm;
|
||||||
|
|
||||||
declare class Account {
|
declare class Account {
|
||||||
constructor();
|
constructor();
|
||||||
free();
|
free(): void;
|
||||||
create();
|
create(): void;
|
||||||
identity_keys(): string;
|
identity_keys(): string;
|
||||||
sign(message: string | Uint8Array): string;
|
sign(message: string | Uint8Array): string;
|
||||||
one_time_keys(): string;
|
one_time_keys(): string;
|
||||||
mark_keys_as_published();
|
mark_keys_as_published(): void;
|
||||||
max_number_of_one_time_keys(): number;
|
max_number_of_one_time_keys(): number;
|
||||||
generate_one_time_keys(number_of_keys: number);
|
generate_one_time_keys(number_of_keys: number): void;
|
||||||
remove_one_time_keys(session: Session);
|
remove_one_time_keys(session: Session): void;
|
||||||
generate_fallback_key();
|
generate_fallback_key(): void;
|
||||||
fallback_key(): string;
|
fallback_key(): string;
|
||||||
unpublished_fallback_key(): string;
|
unpublished_fallback_key(): string;
|
||||||
forget_old_fallback_key(): void;
|
forget_old_fallback_key(): void;
|
||||||
pickle(key: string | Uint8Array): string;
|
pickle(key: string | Uint8Array): string;
|
||||||
unpickle(key: string | Uint8Array, pickle: string);
|
unpickle(key: string | Uint8Array, pickle: string): void;
|
||||||
}
|
}
|
||||||
|
|
||||||
declare class Session {
|
declare class Session {
|
||||||
constructor();
|
constructor();
|
||||||
free(): void;
|
free(): void;
|
||||||
pickle(key: string | Uint8Array): string;
|
pickle(key: string | Uint8Array): string;
|
||||||
unpickle(key: string | Uint8Array, pickle: string);
|
unpickle(key: string | Uint8Array, pickle: string): void;
|
||||||
create_outbound(
|
create_outbound(
|
||||||
account: Account, their_identity_key: string, their_one_time_key: string,
|
account: Account, their_identity_key: string, their_one_time_key: string,
|
||||||
): void;
|
): void;
|
||||||
|
@ -51,7 +51,10 @@ declare class Session {
|
||||||
has_received_message(): boolean;
|
has_received_message(): boolean;
|
||||||
matches_inbound(one_time_key_message: string): boolean;
|
matches_inbound(one_time_key_message: string): boolean;
|
||||||
matches_inbound_from(identity_key: string, one_time_key_message: string): boolean;
|
matches_inbound_from(identity_key: string, one_time_key_message: string): boolean;
|
||||||
encrypt(plaintext: string): object;
|
encrypt(plaintext: string): {
|
||||||
|
type: 0 | 1; // 0: PreKey, 1: Message
|
||||||
|
body: string;
|
||||||
|
};
|
||||||
decrypt(message_type: number, message: string): string;
|
decrypt(message_type: number, message: string): string;
|
||||||
describe(): string;
|
describe(): string;
|
||||||
}
|
}
|
||||||
|
@ -67,10 +70,13 @@ declare class InboundGroupSession {
|
||||||
constructor();
|
constructor();
|
||||||
free(): void;
|
free(): void;
|
||||||
pickle(key: string | Uint8Array): string;
|
pickle(key: string | Uint8Array): string;
|
||||||
unpickle(key: string | Uint8Array, pickle: string);
|
unpickle(key: string | Uint8Array, pickle: string): void;
|
||||||
create(session_key: string): string;
|
create(session_key: string): string;
|
||||||
import_session(session_key: string): string;
|
import_session(session_key: string): string;
|
||||||
decrypt(message: string): object;
|
decrypt(message: string): {
|
||||||
|
message_index: number;
|
||||||
|
plaintext: string;
|
||||||
|
};
|
||||||
session_id(): string;
|
session_id(): string;
|
||||||
first_known_index(): number;
|
first_known_index(): number;
|
||||||
export_session(message_index: number): string;
|
export_session(message_index: number): string;
|
||||||
|
@ -80,7 +86,7 @@ declare class OutboundGroupSession {
|
||||||
constructor();
|
constructor();
|
||||||
free(): void;
|
free(): void;
|
||||||
pickle(key: string | Uint8Array): string;
|
pickle(key: string | Uint8Array): string;
|
||||||
unpickle(key: string | Uint8Array, pickle: string);
|
unpickle(key: string | Uint8Array, pickle: string): void;
|
||||||
create(): void;
|
create(): void;
|
||||||
encrypt(plaintext: string): string;
|
encrypt(plaintext: string): string;
|
||||||
session_id(): string;
|
session_id(): string;
|
||||||
|
@ -92,7 +98,11 @@ declare class PkEncryption {
|
||||||
constructor();
|
constructor();
|
||||||
free(): void;
|
free(): void;
|
||||||
set_recipient_key(key: string): void;
|
set_recipient_key(key: string): void;
|
||||||
encrypt(plaintext: string): object;
|
encrypt(plaintext: string): {
|
||||||
|
ciphertext: string;
|
||||||
|
mac: string;
|
||||||
|
ephemeral: string;
|
||||||
|
};
|
||||||
}
|
}
|
||||||
|
|
||||||
declare class PkDecryption {
|
declare class PkDecryption {
|
||||||
|
|
|
@ -1,3 +1,4 @@
|
||||||
|
/** @constructor */
|
||||||
function InboundGroupSession() {
|
function InboundGroupSession() {
|
||||||
var size = Module['_olm_inbound_group_session_size']();
|
var size = Module['_olm_inbound_group_session_size']();
|
||||||
this.buf = malloc(size);
|
this.buf = malloc(size);
|
||||||
|
|
|
@ -1,3 +1,4 @@
|
||||||
|
/** @constructor */
|
||||||
function OutboundGroupSession() {
|
function OutboundGroupSession() {
|
||||||
var size = Module['_olm_outbound_group_session_size']();
|
var size = Module['_olm_outbound_group_session_size']();
|
||||||
this.buf = malloc(size);
|
this.buf = malloc(size);
|
||||||
|
|
|
@ -1,3 +1,4 @@
|
||||||
|
/** @constructor */
|
||||||
function PkEncryption() {
|
function PkEncryption() {
|
||||||
var size = Module['_olm_pk_encryption_size']();
|
var size = Module['_olm_pk_encryption_size']();
|
||||||
this.buf = malloc(size);
|
this.buf = malloc(size);
|
||||||
|
@ -98,6 +99,7 @@ PkEncryption.prototype['encrypt'] = restore_stack(function(
|
||||||
});
|
});
|
||||||
|
|
||||||
|
|
||||||
|
/** @constructor */
|
||||||
function PkDecryption() {
|
function PkDecryption() {
|
||||||
var size = Module['_olm_pk_decryption_size']();
|
var size = Module['_olm_pk_decryption_size']();
|
||||||
this.buf = malloc(size);
|
this.buf = malloc(size);
|
||||||
|
@ -273,6 +275,7 @@ PkDecryption.prototype['decrypt'] = restore_stack(function (
|
||||||
})
|
})
|
||||||
|
|
||||||
|
|
||||||
|
/** @constructor */
|
||||||
function PkSigning() {
|
function PkSigning() {
|
||||||
var size = Module['_olm_pk_signing_size']();
|
var size = Module['_olm_pk_signing_size']();
|
||||||
this.buf = malloc(size);
|
this.buf = malloc(size);
|
||||||
|
|
|
@ -44,6 +44,7 @@ function bzero(ptr, n) {
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/** @constructor */
|
||||||
function Account() {
|
function Account() {
|
||||||
var size = Module['_olm_account_size']();
|
var size = Module['_olm_account_size']();
|
||||||
this.buf = malloc(size);
|
this.buf = malloc(size);
|
||||||
|
@ -244,6 +245,7 @@ Account.prototype['unpickle'] = restore_stack(function(key, pickle) {
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
|
||||||
|
/** @constructor */
|
||||||
function Session() {
|
function Session() {
|
||||||
var size = Module['_olm_session_size']();
|
var size = Module['_olm_session_size']();
|
||||||
this.buf = malloc(size);
|
this.buf = malloc(size);
|
||||||
|
@ -530,6 +532,7 @@ Session.prototype['describe'] = restore_stack(function() {
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
|
||||||
|
/** @constructor */
|
||||||
function Utility() {
|
function Utility() {
|
||||||
var size = Module['_olm_utility_size']();
|
var size = Module['_olm_utility_size']();
|
||||||
this.buf = malloc(size);
|
this.buf = malloc(size);
|
||||||
|
|
|
@ -14,7 +14,6 @@ if (typeof(window) !== 'undefined') {
|
||||||
var bytes = nodeCrypto['randomBytes'](buf.length);
|
var bytes = nodeCrypto['randomBytes'](buf.length);
|
||||||
buf.set(bytes);
|
buf.set(bytes);
|
||||||
};
|
};
|
||||||
process = global["process"];
|
|
||||||
} else {
|
} else {
|
||||||
throw new Error("Cannot find global to attach library to");
|
throw new Error("Cannot find global to attach library to");
|
||||||
}
|
}
|
||||||
|
|
|
@ -1,3 +1,4 @@
|
||||||
|
/** @constructor */
|
||||||
function SAS() {
|
function SAS() {
|
||||||
var size = Module['_olm_sas_size']();
|
var size = Module['_olm_sas_size']();
|
||||||
var random_length = Module['_olm_create_sas_random_length']();
|
var random_length = Module['_olm_create_sas_random_length']();
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
{
|
{
|
||||||
"name": "@matrix-org/olm",
|
"name": "@matrix-org/olm",
|
||||||
"version": "3.2.11",
|
"version": "3.2.16",
|
||||||
"description": "An implementation of the Double Ratchet cryptographic ratchet",
|
"description": "An implementation of the Double Ratchet cryptographic ratchet",
|
||||||
"main": "olm.js",
|
"main": "olm.js",
|
||||||
"files": [
|
"files": [
|
||||||
|
@ -31,8 +31,5 @@
|
||||||
"homepage": "https://gitlab.matrix.org/matrix-org/olm",
|
"homepage": "https://gitlab.matrix.org/matrix-org/olm",
|
||||||
"devDependencies": {
|
"devDependencies": {
|
||||||
"jasmine": "^3.0.0"
|
"jasmine": "^3.0.0"
|
||||||
},
|
|
||||||
"publishConfig": {
|
|
||||||
"@matrix-org:registry":"https://gitlab.matrix.org/api/v4/projects/27/packages/npm/"
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
|
@ -11,13 +11,13 @@
|
||||||
|
|
||||||
/*************************** HEADER FILES ***************************/
|
/*************************** HEADER FILES ***************************/
|
||||||
#include <stddef.h>
|
#include <stddef.h>
|
||||||
|
#include <stdint.h>
|
||||||
/****************************** MACROS ******************************/
|
/****************************** MACROS ******************************/
|
||||||
#define AES_BLOCK_SIZE 16 // AES operates on 16 bytes at a time
|
#define AES_BLOCK_SIZE 16 // AES operates on 16 bytes at a time
|
||||||
|
|
||||||
/**************************** DATA TYPES ****************************/
|
/**************************** DATA TYPES ****************************/
|
||||||
typedef unsigned char BYTE; // 8-bit byte
|
typedef uint8_t BYTE; // 8-bit byte
|
||||||
typedef unsigned int WORD; // 32-bit word, change to "long" for 16-bit machines
|
typedef uint32_t WORD; // 32-bit word, change to "long" for 16-bit machines
|
||||||
|
|
||||||
/*********************** FUNCTION DECLARATIONS **********************/
|
/*********************** FUNCTION DECLARATIONS **********************/
|
||||||
///////////////////
|
///////////////////
|
||||||
|
|
|
@ -11,13 +11,14 @@
|
||||||
|
|
||||||
/*************************** HEADER FILES ***************************/
|
/*************************** HEADER FILES ***************************/
|
||||||
#include <stddef.h>
|
#include <stddef.h>
|
||||||
|
#include <stdint.h>
|
||||||
|
|
||||||
/****************************** MACROS ******************************/
|
/****************************** MACROS ******************************/
|
||||||
#define SHA256_BLOCK_SIZE 32 // SHA256 outputs a 32 byte digest
|
#define SHA256_BLOCK_SIZE 32 // SHA256 outputs a 32 byte digest
|
||||||
|
|
||||||
/**************************** DATA TYPES ****************************/
|
/**************************** DATA TYPES ****************************/
|
||||||
typedef unsigned char BYTE; // 8-bit byte
|
typedef uint8_t BYTE; // 8-bit byte
|
||||||
typedef unsigned int WORD; // 32-bit word, change to "long" for 16-bit machines
|
typedef uint32_t WORD; // 32-bit word, change to "long" for 16-bit machines
|
||||||
|
|
||||||
typedef struct {
|
typedef struct {
|
||||||
BYTE data[64];
|
BYTE data[64];
|
||||||
|
|
|
@ -4498,7 +4498,7 @@ namespace {
|
||||||
sigaltstack(&sigStack, &oldSigStack);
|
sigaltstack(&sigStack, &oldSigStack);
|
||||||
struct sigaction sa = {};
|
struct sigaction sa = {};
|
||||||
sa.sa_handler = handleSignal; // NOLINT
|
sa.sa_handler = handleSignal; // NOLINT
|
||||||
sa.sa_flags = SA_ONSTACK;
|
sa.sa_flags = SS_ONSTACK;
|
||||||
for(std::size_t i = 0; i < DOCTEST_COUNTOF(signalDefs); ++i) {
|
for(std::size_t i = 0; i < DOCTEST_COUNTOF(signalDefs); ++i) {
|
||||||
sigaction(signalDefs[i].id, &sa, &oldSigActions[i]);
|
sigaction(signalDefs[i].id, &sa, &oldSigActions[i]);
|
||||||
}
|
}
|
||||||
|
|
|
@ -1684,7 +1684,7 @@ namespace {
|
||||||
sigaltstack(&sigStack, &oldSigStack);
|
sigaltstack(&sigStack, &oldSigStack);
|
||||||
struct sigaction sa = {};
|
struct sigaction sa = {};
|
||||||
sa.sa_handler = handleSignal; // NOLINT
|
sa.sa_handler = handleSignal; // NOLINT
|
||||||
sa.sa_flags = SA_ONSTACK;
|
sa.sa_flags = SS_ONSTACK;
|
||||||
for(std::size_t i = 0; i < DOCTEST_COUNTOF(signalDefs); ++i) {
|
for(std::size_t i = 0; i < DOCTEST_COUNTOF(signalDefs); ++i) {
|
||||||
sigaction(signalDefs[i].id, &sa, &oldSigActions[i]);
|
sigaction(signalDefs[i].id, &sa, &oldSigActions[i]);
|
||||||
}
|
}
|
||||||
|
|
76
nix/overlay.nix
Normal file
76
nix/overlay.nix
Normal file
|
@ -0,0 +1,76 @@
|
||||||
|
final: prev: {
|
||||||
|
olm-gcc-cmake = prev.gccStdenv.mkDerivation {
|
||||||
|
name = "olm_gcc_cmake";
|
||||||
|
|
||||||
|
src = ./..;
|
||||||
|
|
||||||
|
nativeBuildInputs = [ prev.cmake ];
|
||||||
|
doCheck = true;
|
||||||
|
checkPhase = ''
|
||||||
|
(cd tests && ctest . -j $NIX_BUILD_CORES)
|
||||||
|
'';
|
||||||
|
};
|
||||||
|
|
||||||
|
olm-clang-cmake = prev.clangStdenv.mkDerivation {
|
||||||
|
name = "olm_clang_cmake";
|
||||||
|
|
||||||
|
src = ./..;
|
||||||
|
|
||||||
|
nativeBuildInputs = [ prev.cmake ];
|
||||||
|
|
||||||
|
doCheck = true;
|
||||||
|
checkPhase = ''
|
||||||
|
(cd tests && ctest . -j $NIX_BUILD_CORES)
|
||||||
|
'';
|
||||||
|
};
|
||||||
|
|
||||||
|
olm-gcc-make = prev.gccStdenv.mkDerivation {
|
||||||
|
name = "olm";
|
||||||
|
|
||||||
|
src = ./..;
|
||||||
|
|
||||||
|
doCheck = true;
|
||||||
|
makeFlags = [ "PREFIX=$out" ];
|
||||||
|
};
|
||||||
|
|
||||||
|
olm-javascript = final.buildEmscriptenPackage {
|
||||||
|
pname = "olm_javascript";
|
||||||
|
inherit (builtins.fromJSON (builtins.readFile ../javascript/package.json)) version;
|
||||||
|
|
||||||
|
src = ./..;
|
||||||
|
|
||||||
|
nativeBuildInputs = with prev; [ gnumake python3 nodejs ];
|
||||||
|
|
||||||
|
postPatch = ''
|
||||||
|
patchShebangs .
|
||||||
|
'';
|
||||||
|
|
||||||
|
configurePhase = false;
|
||||||
|
|
||||||
|
buildPhase = ''
|
||||||
|
export EM_CACHE=$TMPDIR
|
||||||
|
make javascript/exported_functions.json
|
||||||
|
make js
|
||||||
|
'';
|
||||||
|
|
||||||
|
installPhase = ''
|
||||||
|
mkdir -p $out/javascript
|
||||||
|
cd javascript
|
||||||
|
echo sha256: > checksums.txt
|
||||||
|
sha256sum olm.js olm_legacy.js olm.wasm >> checksums.txt
|
||||||
|
echo sha512: >> checksums.txt
|
||||||
|
sha512sum olm.js olm_legacy.js olm.wasm >> checksums.txt
|
||||||
|
cp package.json olm.js olm.wasm olm_legacy.js index.d.ts README.md checksums.txt $out/javascript
|
||||||
|
cd ..
|
||||||
|
'';
|
||||||
|
|
||||||
|
checkPhase = ''
|
||||||
|
cd javascript
|
||||||
|
export HOME=$TMPDIR
|
||||||
|
ln -s ${final.node_modules}/node_modules ./node_modules
|
||||||
|
npm test
|
||||||
|
cd ..
|
||||||
|
'';
|
||||||
|
};
|
||||||
|
|
||||||
|
}
|
|
@ -1,7 +1,7 @@
|
||||||
prefix=@CMAKE_INSTALL_PREFIX@
|
prefix=@CMAKE_INSTALL_PREFIX@
|
||||||
exec_prefix=${prefix}
|
exec_prefix=${prefix}
|
||||||
includedir=${prefix}/@CMAKE_INSTALL_INCLUDEDIR@
|
includedir=@CMAKE_INSTALL_FULL_INCLUDEDIR@
|
||||||
libdir=${exec_prefix}/@CMAKE_INSTALL_LIBDIR@
|
libdir=@CMAKE_INSTALL_FULL_LIBDIR@
|
||||||
|
|
||||||
Name: olm
|
Name: olm
|
||||||
Description: implementation of the Double Ratchet cryptographic ratchet in C++
|
Description: implementation of the Double Ratchet cryptographic ratchet in C++
|
||||||
|
|
|
@ -34,7 +34,7 @@ test:python:
|
||||||
image: docker.io/python:$PYTHON_VERSIONS
|
image: docker.io/python:$PYTHON_VERSIONS
|
||||||
parallel:
|
parallel:
|
||||||
matrix:
|
matrix:
|
||||||
- PYTHON_VERSIONS: [ "3.6", "3.7", "3.8", "3.9" ]
|
- PYTHON_VERSIONS: [ "3.8", "3.9", "3.10", "3.11", "3.12" ]
|
||||||
script:
|
script:
|
||||||
- pip install tox
|
- pip install tox
|
||||||
- make headers
|
- make headers
|
||||||
|
|
|
@ -1,5 +1,3 @@
|
||||||
include include/olm/olm.h
|
include include/olm/*.h
|
||||||
include include/olm/pk.h
|
|
||||||
include include/olm/sas.h
|
|
||||||
include Makefile
|
include Makefile
|
||||||
include olm_build.py
|
include olm_build.py
|
||||||
|
|
|
@ -20,6 +20,9 @@ include/olm/error.h: include/olm/olm.h ../include/olm/error.h
|
||||||
|
|
||||||
headers: include/olm/olm.h include/olm/pk.h include/olm/sas.h include/olm/error.h
|
headers: include/olm/olm.h include/olm/pk.h include/olm/sas.h include/olm/error.h
|
||||||
|
|
||||||
|
olm-python3: headers
|
||||||
|
DEVELOP=$(DEVELOP) python3 setup.py build
|
||||||
|
|
||||||
install: install-python3
|
install: install-python3
|
||||||
|
|
||||||
install-python3: olm-python3
|
install-python3: olm-python3
|
||||||
|
|
|
@ -15,6 +15,18 @@ found [here][6].
|
||||||
|
|
||||||
The full API reference can be found [here][7].
|
The full API reference can be found [here][7].
|
||||||
|
|
||||||
|
# Installation instructions
|
||||||
|
|
||||||
|
To install from the source package, you will need:
|
||||||
|
|
||||||
|
- cmake (recommended) or GNU make
|
||||||
|
- a C/C++ compiler
|
||||||
|
|
||||||
|
You can then run `pip install python-olm`.
|
||||||
|
|
||||||
|
This should work in UNIX-like environments, including macOS, and may work in
|
||||||
|
other environments too, but is known to not work yet in Windows.
|
||||||
|
|
||||||
# Accounts
|
# Accounts
|
||||||
|
|
||||||
Accounts create and hold the central identity of the Olm protocol, they consist of a fingerprint and identity
|
Accounts create and hold the central identity of the Olm protocol, they consist of a fingerprint and identity
|
||||||
|
@ -157,5 +169,5 @@ Pickling works the same way as for peer-to-peer Olm sessions.
|
||||||
[3]: https://cffi.readthedocs.io/en/latest/
|
[3]: https://cffi.readthedocs.io/en/latest/
|
||||||
[4]: https://git.matrix.org/git/olm/about/docs/olm.rst
|
[4]: https://git.matrix.org/git/olm/about/docs/olm.rst
|
||||||
[5]: https://git.matrix.org/git/olm/about/docs/megolm.rst
|
[5]: https://git.matrix.org/git/olm/about/docs/megolm.rst
|
||||||
[6]: https://matrix.org/docs/guides/e2e_implementation.html
|
[6]: https://matrix.org/docs/guides/end-to-end-encryption-implementation-guide
|
||||||
[7]: https://poljar.github.io/python-olm/html/index.html
|
[7]: https://poljar.github.io/python-olm/html/index.html
|
||||||
|
|
35
python/make_sdist.sh
Executable file
35
python/make_sdist.sh
Executable file
|
@ -0,0 +1,35 @@
|
||||||
|
#!/bin/bash
|
||||||
|
set -e
|
||||||
|
|
||||||
|
DIR=$(mktemp -d)
|
||||||
|
SRC=$(pwd)
|
||||||
|
|
||||||
|
echo "Making headers"
|
||||||
|
make headers
|
||||||
|
|
||||||
|
cd $DIR
|
||||||
|
|
||||||
|
echo "Copying python module"
|
||||||
|
cp -a $SRC/* .
|
||||||
|
mkdir -p libolm
|
||||||
|
echo "Cleaning sources"
|
||||||
|
make clean > /dev/null
|
||||||
|
cp -a $SRC/include .
|
||||||
|
echo "Copying libolm sources"
|
||||||
|
for src in cmake CMakeLists.txt common.mk include lib Makefile olm.pc.in src tests; do
|
||||||
|
cp -a $SRC/../$src libolm
|
||||||
|
done
|
||||||
|
find libolm -name \*~ -delete
|
||||||
|
find libolm -name \#\*\# -delete
|
||||||
|
|
||||||
|
echo "Building"
|
||||||
|
patch -p1 < $SRC/packaging.diff
|
||||||
|
python3 -m build -s
|
||||||
|
|
||||||
|
echo "Copying result"
|
||||||
|
mkdir -p $SRC/dist
|
||||||
|
cp dist/* $SRC/dist
|
||||||
|
|
||||||
|
echo "Cleaning up"
|
||||||
|
cd $SRC
|
||||||
|
rm -rf $DIR
|
|
@ -1,9 +0,0 @@
|
||||||
__title__ = "python-olm"
|
|
||||||
__description__ = ("python CFFI bindings for the olm "
|
|
||||||
"cryptographic ratchet library")
|
|
||||||
__url__ = "https://github.com/poljar/python-olm"
|
|
||||||
__version__ = "3.2.11"
|
|
||||||
__author__ = "Damir Jelić"
|
|
||||||
__author_email__ = "poljar@termina.org.uk"
|
|
||||||
__license__ = "Apache 2.0"
|
|
||||||
__copyright__ = "Copyright 2018-2019 Damir Jelić"
|
|
|
@ -23,7 +23,6 @@
|
||||||
|
|
||||||
This is designed for avoiding __del__.
|
This is designed for avoiding __del__.
|
||||||
"""
|
"""
|
||||||
from __future__ import print_function
|
|
||||||
|
|
||||||
import sys
|
import sys
|
||||||
import traceback
|
import traceback
|
||||||
|
|
|
@ -32,8 +32,6 @@ import json
|
||||||
from builtins import bytes, super
|
from builtins import bytes, super
|
||||||
from typing import AnyStr, Dict, Optional, Type
|
from typing import AnyStr, Dict, Optional, Type
|
||||||
|
|
||||||
from future.utils import bytes_to_native_str
|
|
||||||
|
|
||||||
# pylint: disable=no-name-in-module
|
# pylint: disable=no-name-in-module
|
||||||
from _libolm import ffi, lib # type: ignore
|
from _libolm import ffi, lib # type: ignore
|
||||||
|
|
||||||
|
@ -93,8 +91,7 @@ class Account(object):
|
||||||
if ret != lib.olm_error():
|
if ret != lib.olm_error():
|
||||||
return
|
return
|
||||||
|
|
||||||
last_error = bytes_to_native_str(
|
last_error = ffi.string((lib.olm_account_last_error(self._account))).decode()
|
||||||
ffi.string((lib.olm_account_last_error(self._account))))
|
|
||||||
|
|
||||||
raise OlmAccountError(last_error)
|
raise OlmAccountError(last_error)
|
||||||
|
|
||||||
|
@ -209,7 +206,7 @@ class Account(object):
|
||||||
for i in range(0, len(bytes_message)):
|
for i in range(0, len(bytes_message)):
|
||||||
bytes_message[i] = 0
|
bytes_message[i] = 0
|
||||||
|
|
||||||
return bytes_to_native_str(ffi.unpack(out_buffer, out_length))
|
return ffi.unpack(out_buffer, out_length).decode()
|
||||||
|
|
||||||
@property
|
@property
|
||||||
def max_one_time_keys(self):
|
def max_one_time_keys(self):
|
||||||
|
|
|
@ -28,8 +28,6 @@ Examples:
|
||||||
from builtins import bytes, super
|
from builtins import bytes, super
|
||||||
from typing import AnyStr, Optional, Tuple, Type
|
from typing import AnyStr, Optional, Tuple, Type
|
||||||
|
|
||||||
from future.utils import bytes_to_native_str
|
|
||||||
|
|
||||||
# pylint: disable=no-name-in-module
|
# pylint: disable=no-name-in-module
|
||||||
from _libolm import ffi, lib # type: ignore
|
from _libolm import ffi, lib # type: ignore
|
||||||
|
|
||||||
|
@ -171,8 +169,9 @@ class InboundGroupSession(object):
|
||||||
if ret != lib.olm_error():
|
if ret != lib.olm_error():
|
||||||
return
|
return
|
||||||
|
|
||||||
last_error = bytes_to_native_str(ffi.string(
|
last_error = ffi.string(
|
||||||
lib.olm_inbound_group_session_last_error(self._session)))
|
lib.olm_inbound_group_session_last_error(self._session)
|
||||||
|
).decode()
|
||||||
|
|
||||||
raise OlmGroupSessionError(last_error)
|
raise OlmGroupSessionError(last_error)
|
||||||
|
|
||||||
|
@ -252,7 +251,7 @@ class InboundGroupSession(object):
|
||||||
id_length
|
id_length
|
||||||
)
|
)
|
||||||
self._check_error(ret)
|
self._check_error(ret)
|
||||||
return bytes_to_native_str(ffi.unpack(id_buffer, id_length))
|
return ffi.unpack(id_buffer, id_length).decode()
|
||||||
|
|
||||||
@property
|
@property
|
||||||
def first_known_index(self):
|
def first_known_index(self):
|
||||||
|
@ -290,7 +289,7 @@ class InboundGroupSession(object):
|
||||||
message_index
|
message_index
|
||||||
)
|
)
|
||||||
self._check_error(ret)
|
self._check_error(ret)
|
||||||
export_str = bytes_to_native_str(ffi.unpack(export_buffer, export_length))
|
export_str = ffi.unpack(export_buffer, export_length).decode()
|
||||||
|
|
||||||
# clear out copies of the key
|
# clear out copies of the key
|
||||||
lib.memset(export_buffer, 0, export_length)
|
lib.memset(export_buffer, 0, export_length)
|
||||||
|
@ -373,9 +372,9 @@ class OutboundGroupSession(object):
|
||||||
if ret != lib.olm_error():
|
if ret != lib.olm_error():
|
||||||
return
|
return
|
||||||
|
|
||||||
last_error = bytes_to_native_str(ffi.string(
|
last_error = ffi.string(
|
||||||
lib.olm_outbound_group_session_last_error(self._session)
|
lib.olm_outbound_group_session_last_error(self._session)
|
||||||
))
|
).decode()
|
||||||
|
|
||||||
raise OlmGroupSessionError(last_error)
|
raise OlmGroupSessionError(last_error)
|
||||||
|
|
||||||
|
@ -483,7 +482,7 @@ class OutboundGroupSession(object):
|
||||||
for i in range(0, len(byte_plaintext)):
|
for i in range(0, len(byte_plaintext)):
|
||||||
byte_plaintext[i] = 0
|
byte_plaintext[i] = 0
|
||||||
|
|
||||||
return bytes_to_native_str(ffi.unpack(message_buffer, message_length))
|
return ffi.unpack(message_buffer, message_length).decode()
|
||||||
|
|
||||||
@property
|
@property
|
||||||
def id(self):
|
def id(self):
|
||||||
|
@ -499,7 +498,7 @@ class OutboundGroupSession(object):
|
||||||
)
|
)
|
||||||
self._check_error(ret)
|
self._check_error(ret)
|
||||||
|
|
||||||
return bytes_to_native_str(ffi.unpack(id_buffer, id_length))
|
return ffi.unpack(id_buffer, id_length).decode()
|
||||||
|
|
||||||
@property
|
@property
|
||||||
def message_index(self):
|
def message_index(self):
|
||||||
|
@ -529,4 +528,4 @@ class OutboundGroupSession(object):
|
||||||
)
|
)
|
||||||
self._check_error(ret)
|
self._check_error(ret)
|
||||||
|
|
||||||
return bytes_to_native_str(ffi.unpack(key_buffer, key_length))
|
return ffi.unpack(key_buffer, key_length).decode()
|
||||||
|
|
|
@ -36,8 +36,6 @@ Examples:
|
||||||
from builtins import super
|
from builtins import super
|
||||||
from typing import AnyStr, Type
|
from typing import AnyStr, Type
|
||||||
|
|
||||||
from future.utils import bytes_to_native_str
|
|
||||||
|
|
||||||
from _libolm import ffi, lib # type: ignore
|
from _libolm import ffi, lib # type: ignore
|
||||||
|
|
||||||
from ._compat import URANDOM, to_bytearray, to_unicode_str
|
from ._compat import URANDOM, to_bytearray, to_unicode_str
|
||||||
|
@ -116,8 +114,9 @@ class PkEncryption(object):
|
||||||
if ret != lib.olm_error():
|
if ret != lib.olm_error():
|
||||||
return
|
return
|
||||||
|
|
||||||
last_error = bytes_to_native_str(
|
last_error = ffi.string(
|
||||||
ffi.string(lib.olm_pk_encryption_last_error(self._pk_encryption)))
|
lib.olm_pk_encryption_last_error(self._pk_encryption)
|
||||||
|
).decode()
|
||||||
|
|
||||||
raise PkEncryptionError(last_error)
|
raise PkEncryptionError(last_error)
|
||||||
|
|
||||||
|
@ -166,12 +165,9 @@ class PkEncryption(object):
|
||||||
byte_plaintext[i] = 0
|
byte_plaintext[i] = 0
|
||||||
|
|
||||||
message = PkMessage(
|
message = PkMessage(
|
||||||
bytes_to_native_str(
|
ffi.unpack(ephemeral_key, ephemeral_key_size).decode(),
|
||||||
ffi.unpack(ephemeral_key, ephemeral_key_size)),
|
ffi.unpack(mac, mac_length).decode(),
|
||||||
bytes_to_native_str(
|
ffi.unpack(ciphertext, ciphertext_length).decode(),
|
||||||
ffi.unpack(mac, mac_length)),
|
|
||||||
bytes_to_native_str(
|
|
||||||
ffi.unpack(ciphertext, ciphertext_length))
|
|
||||||
)
|
)
|
||||||
return message
|
return message
|
||||||
|
|
||||||
|
@ -217,18 +213,19 @@ class PkDecryption(object):
|
||||||
random_buffer, random_length
|
random_buffer, random_length
|
||||||
)
|
)
|
||||||
self._check_error(ret)
|
self._check_error(ret)
|
||||||
self.public_key = bytes_to_native_str(ffi.unpack(
|
self.public_key: str = ffi.unpack(
|
||||||
key_buffer,
|
key_buffer,
|
||||||
key_length
|
key_length
|
||||||
))
|
).decode()
|
||||||
|
|
||||||
def _check_error(self, ret):
|
def _check_error(self, ret):
|
||||||
# type: (int) -> None
|
# type: (int) -> None
|
||||||
if ret != lib.olm_error():
|
if ret != lib.olm_error():
|
||||||
return
|
return
|
||||||
|
|
||||||
last_error = bytes_to_native_str(
|
last_error = ffi.string(
|
||||||
ffi.string(lib.olm_pk_decryption_last_error(self._pk_decryption)))
|
lib.olm_pk_decryption_last_error(self._pk_decryption)
|
||||||
|
).decode()
|
||||||
|
|
||||||
raise PkDecryptionError(last_error)
|
raise PkDecryptionError(last_error)
|
||||||
|
|
||||||
|
@ -267,7 +264,7 @@ class PkDecryption(object):
|
||||||
|
|
||||||
@classmethod
|
@classmethod
|
||||||
def from_pickle(cls, pickle, passphrase=""):
|
def from_pickle(cls, pickle, passphrase=""):
|
||||||
# types: (bytes, str) -> PkDecryption
|
# type: (bytes, str) -> PkDecryption
|
||||||
"""Restore a previously stored PkDecryption object.
|
"""Restore a previously stored PkDecryption object.
|
||||||
|
|
||||||
Creates a PkDecryption object from a pickled base64 string. Decrypts
|
Creates a PkDecryption object from a pickled base64 string. Decrypts
|
||||||
|
@ -306,15 +303,15 @@ class PkDecryption(object):
|
||||||
for i in range(0, len(byte_key)):
|
for i in range(0, len(byte_key)):
|
||||||
byte_key[i] = 0
|
byte_key[i] = 0
|
||||||
|
|
||||||
obj.public_key = bytes_to_native_str(ffi.unpack(
|
obj.public_key = ffi.unpack(
|
||||||
pubkey_buffer,
|
pubkey_buffer,
|
||||||
pubkey_length
|
pubkey_length
|
||||||
))
|
).decode()
|
||||||
|
|
||||||
return obj
|
return obj
|
||||||
|
|
||||||
def decrypt(self, message, unicode_errors="replace"):
|
def decrypt(self, message, unicode_errors="replace"):
|
||||||
# type (PkMessage, str) -> str
|
# type: (PkMessage, str) -> str
|
||||||
"""Decrypt a previously encrypted Pk message.
|
"""Decrypt a previously encrypted Pk message.
|
||||||
|
|
||||||
Returns the decrypted plaintext.
|
Returns the decrypted plaintext.
|
||||||
|
@ -411,17 +408,14 @@ class PkSigning(object):
|
||||||
|
|
||||||
self._check_error(ret)
|
self._check_error(ret)
|
||||||
|
|
||||||
self.public_key = bytes_to_native_str(
|
self.public_key = ffi.unpack(pubkey_buffer, pubkey_length).decode()
|
||||||
ffi.unpack(pubkey_buffer, pubkey_length)
|
|
||||||
)
|
|
||||||
|
|
||||||
def _check_error(self, ret):
|
def _check_error(self, ret):
|
||||||
# type: (int) -> None
|
# type: (int) -> None
|
||||||
if ret != lib.olm_error():
|
if ret != lib.olm_error():
|
||||||
return
|
return
|
||||||
|
|
||||||
last_error = bytes_to_native_str(
|
last_error = ffi.string(lib.olm_pk_signing_last_error(self._pk_signing)).decode()
|
||||||
ffi.string(lib.olm_pk_signing_last_error(self._pk_signing)))
|
|
||||||
|
|
||||||
raise PkSigningError(last_error)
|
raise PkSigningError(last_error)
|
||||||
|
|
||||||
|
@ -456,6 +450,4 @@ class PkSigning(object):
|
||||||
signature_buffer, signature_length)
|
signature_buffer, signature_length)
|
||||||
self._check_error(ret)
|
self._check_error(ret)
|
||||||
|
|
||||||
return bytes_to_native_str(
|
return ffi.unpack(signature_buffer, signature_length).decode()
|
||||||
ffi.unpack(signature_buffer, signature_length)
|
|
||||||
)
|
|
||||||
|
|
0
python/olm/py.typed
Normal file
0
python/olm/py.typed
Normal file
|
@ -34,8 +34,6 @@ from builtins import bytes
|
||||||
from functools import wraps
|
from functools import wraps
|
||||||
from typing import Optional
|
from typing import Optional
|
||||||
|
|
||||||
from future.utils import bytes_to_native_str
|
|
||||||
|
|
||||||
from _libolm import ffi, lib
|
from _libolm import ffi, lib
|
||||||
|
|
||||||
from ._compat import URANDOM, to_bytearray, to_bytes
|
from ._compat import URANDOM, to_bytearray, to_bytes
|
||||||
|
@ -92,8 +90,7 @@ class Sas(object):
|
||||||
if ret != lib.olm_error():
|
if ret != lib.olm_error():
|
||||||
return
|
return
|
||||||
|
|
||||||
last_error = bytes_to_native_str(
|
last_error = ffi.string((lib.olm_sas_last_error(self._sas))).decode()
|
||||||
ffi.string((lib.olm_sas_last_error(self._sas))))
|
|
||||||
|
|
||||||
raise OlmSasError(last_error)
|
raise OlmSasError(last_error)
|
||||||
|
|
||||||
|
@ -115,7 +112,7 @@ class Sas(object):
|
||||||
lib.olm_sas_get_pubkey(self._sas, pubkey_buffer, pubkey_length)
|
lib.olm_sas_get_pubkey(self._sas, pubkey_buffer, pubkey_length)
|
||||||
)
|
)
|
||||||
|
|
||||||
return bytes_to_native_str(ffi.unpack(pubkey_buffer, pubkey_length))
|
return ffi.unpack(pubkey_buffer, pubkey_length).decode()
|
||||||
|
|
||||||
@property
|
@property
|
||||||
def other_key_set(self):
|
def other_key_set(self):
|
||||||
|
@ -208,7 +205,7 @@ class Sas(object):
|
||||||
mac_length
|
mac_length
|
||||||
)
|
)
|
||||||
)
|
)
|
||||||
return bytes_to_native_str(ffi.unpack(mac_buffer, mac_length))
|
return ffi.unpack(mac_buffer, mac_length).decode()
|
||||||
|
|
||||||
def calculate_mac_fixed_base64(self, message, extra_info):
|
def calculate_mac_fixed_base64(self, message, extra_info):
|
||||||
# type: (str, str) -> str
|
# type: (str, str) -> str
|
||||||
|
@ -242,7 +239,7 @@ class Sas(object):
|
||||||
mac_length
|
mac_length
|
||||||
)
|
)
|
||||||
)
|
)
|
||||||
return bytes_to_native_str(ffi.unpack(mac_buffer, mac_length))
|
return ffi.unpack(mac_buffer, mac_length).decode()
|
||||||
|
|
||||||
def calculate_mac_long_kdf(self, message, extra_info):
|
def calculate_mac_long_kdf(self, message, extra_info):
|
||||||
# type: (str, str) -> str
|
# type: (str, str) -> str
|
||||||
|
@ -276,4 +273,4 @@ class Sas(object):
|
||||||
mac_length
|
mac_length
|
||||||
)
|
)
|
||||||
)
|
)
|
||||||
return bytes_to_native_str(ffi.unpack(mac_buffer, mac_length))
|
return ffi.unpack(mac_buffer, mac_length).decode()
|
||||||
|
|
|
@ -35,8 +35,6 @@ Examples:
|
||||||
from builtins import bytes, super
|
from builtins import bytes, super
|
||||||
from typing import AnyStr, Optional, Type
|
from typing import AnyStr, Optional, Type
|
||||||
|
|
||||||
from future.utils import bytes_to_native_str
|
|
||||||
|
|
||||||
# pylint: disable=no-name-in-module
|
# pylint: disable=no-name-in-module
|
||||||
from _libolm import ffi, lib # type: ignore
|
from _libolm import ffi, lib # type: ignore
|
||||||
|
|
||||||
|
@ -146,8 +144,7 @@ class Session(object):
|
||||||
if ret != lib.olm_error():
|
if ret != lib.olm_error():
|
||||||
return
|
return
|
||||||
|
|
||||||
last_error = bytes_to_native_str(
|
last_error = ffi.string(lib.olm_session_last_error(self._session)).decode()
|
||||||
ffi.string(lib.olm_session_last_error(self._session)))
|
|
||||||
|
|
||||||
raise OlmSessionError(last_error)
|
raise OlmSessionError(last_error)
|
||||||
|
|
||||||
|
@ -260,16 +257,16 @@ class Session(object):
|
||||||
|
|
||||||
if message_type == lib.OLM_MESSAGE_TYPE_PRE_KEY:
|
if message_type == lib.OLM_MESSAGE_TYPE_PRE_KEY:
|
||||||
return OlmPreKeyMessage(
|
return OlmPreKeyMessage(
|
||||||
bytes_to_native_str(ffi.unpack(
|
ffi.unpack(
|
||||||
ciphertext_buffer,
|
ciphertext_buffer,
|
||||||
ciphertext_length
|
ciphertext_length
|
||||||
)))
|
).decode())
|
||||||
elif message_type == lib.OLM_MESSAGE_TYPE_MESSAGE:
|
elif message_type == lib.OLM_MESSAGE_TYPE_MESSAGE:
|
||||||
return OlmMessage(
|
return OlmMessage(
|
||||||
bytes_to_native_str(ffi.unpack(
|
ffi.unpack(
|
||||||
ciphertext_buffer,
|
ciphertext_buffer,
|
||||||
ciphertext_length
|
ciphertext_length
|
||||||
)))
|
).decode())
|
||||||
else: # pragma: no cover
|
else: # pragma: no cover
|
||||||
raise ValueError("Unknown message type")
|
raise ValueError("Unknown message type")
|
||||||
|
|
||||||
|
@ -340,7 +337,7 @@ class Session(object):
|
||||||
self._check_error(
|
self._check_error(
|
||||||
lib.olm_session_id(self._session, id_buffer, id_length)
|
lib.olm_session_id(self._session, id_buffer, id_length)
|
||||||
)
|
)
|
||||||
return bytes_to_native_str(ffi.unpack(id_buffer, id_length))
|
return ffi.unpack(id_buffer, id_length).decode()
|
||||||
|
|
||||||
def matches(self, message, identity_key=None):
|
def matches(self, message, identity_key=None):
|
||||||
# type: (OlmPreKeyMessage, Optional[AnyStr]) -> bool
|
# type: (OlmPreKeyMessage, Optional[AnyStr]) -> bool
|
||||||
|
@ -407,7 +404,7 @@ class Session(object):
|
||||||
lib.olm_session_describe(
|
lib.olm_session_describe(
|
||||||
self._session, describe_buffer, buffer_length
|
self._session, describe_buffer, buffer_length
|
||||||
)
|
)
|
||||||
return bytes_to_native_str(ffi.string(describe_buffer))
|
return ffi.string(describe_buffer).decode()
|
||||||
|
|
||||||
|
|
||||||
class InboundSession(Session):
|
class InboundSession(Session):
|
||||||
|
|
|
@ -33,8 +33,6 @@ Examples:
|
||||||
# pylint: disable=redefined-builtin,unused-import
|
# pylint: disable=redefined-builtin,unused-import
|
||||||
from typing import AnyStr, Type
|
from typing import AnyStr, Type
|
||||||
|
|
||||||
from future.utils import bytes_to_native_str
|
|
||||||
|
|
||||||
# pylint: disable=no-name-in-module
|
# pylint: disable=no-name-in-module
|
||||||
from _libolm import ffi, lib # type: ignore
|
from _libolm import ffi, lib # type: ignore
|
||||||
|
|
||||||
|
@ -123,7 +121,7 @@ class _Utility(object):
|
||||||
|
|
||||||
cls._check_error(ret, OlmHashError)
|
cls._check_error(ret, OlmHashError)
|
||||||
|
|
||||||
return bytes_to_native_str(ffi.unpack(hash, hash_length))
|
return ffi.unpack(hash, hash_length).decode()
|
||||||
|
|
||||||
|
|
||||||
def ed25519_verify(key, message, signature):
|
def ed25519_verify(key, message, signature):
|
||||||
|
|
|
@ -15,8 +15,6 @@
|
||||||
# CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
|
# CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
|
||||||
# CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
# CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
||||||
|
|
||||||
from __future__ import unicode_literals
|
|
||||||
|
|
||||||
import os
|
import os
|
||||||
import subprocess
|
import subprocess
|
||||||
|
|
||||||
|
@ -28,7 +26,6 @@ PATH = os.path.dirname(__file__)
|
||||||
DEVELOP = os.environ.get("DEVELOP")
|
DEVELOP = os.environ.get("DEVELOP")
|
||||||
|
|
||||||
compile_args = ["-I../include"]
|
compile_args = ["-I../include"]
|
||||||
link_args = ["-L../build"]
|
|
||||||
|
|
||||||
if DEVELOP and DEVELOP.lower() in ["yes", "true", "1"]:
|
if DEVELOP and DEVELOP.lower() in ["yes", "true", "1"]:
|
||||||
link_args.append('-Wl,-rpath=../build')
|
link_args.append('-Wl,-rpath=../build')
|
||||||
|
@ -46,8 +43,10 @@ ffibuilder.set_source(
|
||||||
#include <olm/sas.h>
|
#include <olm/sas.h>
|
||||||
""",
|
""",
|
||||||
libraries=["olm"],
|
libraries=["olm"],
|
||||||
|
library_dirs=[os.path.join("..", "build")],
|
||||||
extra_compile_args=compile_args,
|
extra_compile_args=compile_args,
|
||||||
extra_link_args=link_args)
|
source_extension=".cpp", # we need to link the C++ standard library, so use a C++ extension
|
||||||
|
)
|
||||||
|
|
||||||
with open(os.path.join(PATH, "include/olm/error.h")) as f:
|
with open(os.path.join(PATH, "include/olm/error.h")) as f:
|
||||||
ffibuilder.cdef(f.read(), override=True)
|
ffibuilder.cdef(f.read(), override=True)
|
||||||
|
|
56
python/packaging.diff
Normal file
56
python/packaging.diff
Normal file
|
@ -0,0 +1,56 @@
|
||||||
|
--- a/MANIFEST.in
|
||||||
|
+++ b/MANIFEST.in
|
||||||
|
@@ -1,3 +1,8 @@
|
||||||
|
include include/olm/*.h
|
||||||
|
-include Makefile
|
||||||
|
include olm_build.py
|
||||||
|
+include libolm/*
|
||||||
|
+include libolm/cmake/*
|
||||||
|
+include libolm/include/olm/*
|
||||||
|
+recursive-include libolm/lib *
|
||||||
|
+include libolm/src/*
|
||||||
|
+recursive-include libolm/tests *
|
||||||
|
--- a/olm_build.py
|
||||||
|
+++ b/olm_build.py
|
||||||
|
@@ -25,12 +25,29 @@
|
||||||
|
|
||||||
|
DEVELOP = os.environ.get("DEVELOP")
|
||||||
|
|
||||||
|
-compile_args = ["-I../include"]
|
||||||
|
+compile_args = ["-Ilibolm/include"]
|
||||||
|
|
||||||
|
if DEVELOP and DEVELOP.lower() in ["yes", "true", "1"]:
|
||||||
|
link_args.append('-Wl,-rpath=../build')
|
||||||
|
|
||||||
|
-headers_build = subprocess.Popen("make headers", shell=True)
|
||||||
|
-headers_build.wait()
|
||||||
|
+# Try to build with cmake first, fall back to GNU make
|
||||||
|
+try:
|
||||||
|
+ subprocess.run(
|
||||||
|
+ ["cmake", ".", "-Bbuild", "-DBUILD_SHARED_LIBS=NO"],
|
||||||
|
+ cwd="libolm", check=True,
|
||||||
|
+ )
|
||||||
|
+ subprocess.run(
|
||||||
|
+ ["cmake", "--build", "build"],
|
||||||
|
+ cwd="libolm", check=True,
|
||||||
|
+ )
|
||||||
|
+except FileNotFoundError:
|
||||||
|
+ try:
|
||||||
|
+ # try "gmake" first because some systems have a non-GNU make
|
||||||
|
+ # installed as "make"
|
||||||
|
+ subprocess.run(["gmake", "static"], cwd="libolm", check=True)
|
||||||
|
+ except FileNotFoundError:
|
||||||
|
+ # some systems have GNU make installed without the leading "g"
|
||||||
|
+ # so give that a try (though this may fail if it isn't GNU make)
|
||||||
|
+ subprocess.run(["make", "static"], cwd="libolm", check=True)
|
||||||
|
|
||||||
|
ffibuilder.set_source(
|
||||||
|
@@ -43,7 +60,7 @@
|
||||||
|
#include <olm/sas.h>
|
||||||
|
""",
|
||||||
|
libraries=["olm"],
|
||||||
|
- library_dirs=[os.path.join("..", "build")],
|
||||||
|
+ library_dirs=[os.path.join("libolm", "build")],
|
||||||
|
extra_compile_args=compile_args,
|
||||||
|
source_extension=".cpp", # we need to link the C++ standard library, so use a C++ extension
|
||||||
|
)
|
22
python/pyproject.toml
Normal file
22
python/pyproject.toml
Normal file
|
@ -0,0 +1,22 @@
|
||||||
|
[build-system]
|
||||||
|
requires = ["setuptools", "cffi>=1.0.0"]
|
||||||
|
build-backend = "setuptools.build_meta"
|
||||||
|
|
||||||
|
[project]
|
||||||
|
name = "python-olm"
|
||||||
|
version = "3.2.16"
|
||||||
|
description = "python CFFI bindings for the olm cryptographic ratchet library"
|
||||||
|
authors = [{name = "Damir Jelić", email = "poljar@termina.org.uk"}]
|
||||||
|
license = {text = "Apache-2.0"}
|
||||||
|
readme = "README.md"
|
||||||
|
classifiers = [
|
||||||
|
"License :: OSI Approved :: Apache Software License",
|
||||||
|
"Topic :: Communications",
|
||||||
|
]
|
||||||
|
dependencies = ["cffi>=1.0.0"]
|
||||||
|
|
||||||
|
[project.urls]
|
||||||
|
homepage = "https://gitlab.matrix.org/matrix-org/olm/-/tree/master/python"
|
||||||
|
|
||||||
|
[tool.setuptools]
|
||||||
|
packages = [ "olm" ]
|
|
@ -1,3 +1,2 @@
|
||||||
future
|
|
||||||
cffi
|
cffi
|
||||||
typing
|
typing
|
||||||
|
|
|
@ -3,6 +3,3 @@ testpaths = tests
|
||||||
flake8-ignore =
|
flake8-ignore =
|
||||||
olm/*.py F401
|
olm/*.py F401
|
||||||
tests/*.py W503
|
tests/*.py W503
|
||||||
|
|
||||||
[coverage:run]
|
|
||||||
omit=olm/__version__.py
|
|
||||||
|
|
|
@ -1,31 +1,6 @@
|
||||||
# -*- coding: utf-8 -*-
|
# -*- coding: utf-8 -*-
|
||||||
|
|
||||||
import os
|
|
||||||
from codecs import open
|
|
||||||
|
|
||||||
from setuptools import setup
|
from setuptools import setup
|
||||||
|
|
||||||
here = os.path.abspath(os.path.dirname(__file__))
|
|
||||||
|
|
||||||
about = {}
|
|
||||||
with open(os.path.join(here, "olm", "__version__.py"), "r", "utf-8") as f:
|
|
||||||
exec(f.read(), about)
|
|
||||||
|
|
||||||
setup(
|
setup(
|
||||||
name=about["__title__"],
|
cffi_modules=["olm_build.py:ffibuilder"]
|
||||||
version=about["__version__"],
|
|
||||||
description=about["__description__"],
|
|
||||||
author=about["__author__"],
|
|
||||||
author_email=about["__author_email__"],
|
|
||||||
url=about["__url__"],
|
|
||||||
license=about["__license__"],
|
|
||||||
packages=["olm"],
|
|
||||||
setup_requires=["cffi>=1.0.0"],
|
|
||||||
cffi_modules=["olm_build.py:ffibuilder"],
|
|
||||||
install_requires=[
|
|
||||||
"cffi>=1.0.0",
|
|
||||||
"future",
|
|
||||||
"typing;python_version<'3.5'"
|
|
||||||
],
|
|
||||||
zip_safe=False
|
|
||||||
)
|
)
|
||||||
|
|
|
@ -1,8 +1,6 @@
|
||||||
import base64
|
import base64
|
||||||
import hashlib
|
import hashlib
|
||||||
|
|
||||||
from future.utils import bytes_to_native_str
|
|
||||||
|
|
||||||
from olm import sha256
|
from olm import sha256
|
||||||
from olm._compat import to_bytes
|
from olm._compat import to_bytes
|
||||||
|
|
||||||
|
@ -19,7 +17,7 @@ class TestClass(object):
|
||||||
hashlib.sha256(to_bytes(input1)).digest()
|
hashlib.sha256(to_bytes(input1)).digest()
|
||||||
)
|
)
|
||||||
|
|
||||||
hashlib_hash = bytes_to_native_str(hashlib_hash[:-1])
|
hashlib_hash = hashlib_hash[:-1].decode()
|
||||||
|
|
||||||
assert first_hash != second_hash
|
assert first_hash != second_hash
|
||||||
assert hashlib_hash == first_hash
|
assert hashlib_hash == first_hash
|
||||||
|
|
|
@ -6,7 +6,7 @@ envlist = py27,py36,pypy,{py2,py3}-cov,coverage
|
||||||
deps = -rrequirements.txt
|
deps = -rrequirements.txt
|
||||||
-rtest-requirements.txt
|
-rtest-requirements.txt
|
||||||
|
|
||||||
passenv = TOXENV CI TRAVIS TRAVIS_*
|
passenv = TOXENV,CI,TRAVIS,TRAVIS_*
|
||||||
commands = pytest --benchmark-disable
|
commands = pytest --benchmark-disable
|
||||||
usedevelop = True
|
usedevelop = True
|
||||||
|
|
||||||
|
|
|
@ -437,7 +437,7 @@ void olm::Session::describe(char *describe_buffer, size_t buflen) {
|
||||||
|
|
||||||
size = snprintf(
|
size = snprintf(
|
||||||
describe_buffer, remaining,
|
describe_buffer, remaining,
|
||||||
"sender chain index: %d ", ratchet.sender_chain[0].chain_key.index
|
"sender chain index: %lu ", ratchet.sender_chain[0].chain_key.index
|
||||||
);
|
);
|
||||||
CHECK_SIZE_AND_ADVANCE;
|
CHECK_SIZE_AND_ADVANCE;
|
||||||
|
|
||||||
|
@ -447,7 +447,7 @@ void olm::Session::describe(char *describe_buffer, size_t buflen) {
|
||||||
for (size_t i = 0; i < ratchet.receiver_chains.size(); ++i) {
|
for (size_t i = 0; i < ratchet.receiver_chains.size(); ++i) {
|
||||||
size = snprintf(
|
size = snprintf(
|
||||||
describe_buffer, remaining,
|
describe_buffer, remaining,
|
||||||
" %d", ratchet.receiver_chains[i].chain_key.index
|
" %lu", ratchet.receiver_chains[i].chain_key.index
|
||||||
);
|
);
|
||||||
CHECK_SIZE_AND_ADVANCE;
|
CHECK_SIZE_AND_ADVANCE;
|
||||||
}
|
}
|
||||||
|
@ -458,7 +458,7 @@ void olm::Session::describe(char *describe_buffer, size_t buflen) {
|
||||||
for (size_t i = 0; i < ratchet.skipped_message_keys.size(); ++i) {
|
for (size_t i = 0; i < ratchet.skipped_message_keys.size(); ++i) {
|
||||||
size = snprintf(
|
size = snprintf(
|
||||||
describe_buffer, remaining,
|
describe_buffer, remaining,
|
||||||
" %d", ratchet.skipped_message_keys[i].message_key.index
|
" %lu", ratchet.skipped_message_keys[i].message_key.index
|
||||||
);
|
);
|
||||||
CHECK_SIZE_AND_ADVANCE;
|
CHECK_SIZE_AND_ADVANCE;
|
||||||
}
|
}
|
||||||
|
|
|
@ -4498,7 +4498,7 @@ namespace {
|
||||||
sigaltstack(&sigStack, &oldSigStack);
|
sigaltstack(&sigStack, &oldSigStack);
|
||||||
struct sigaction sa = {};
|
struct sigaction sa = {};
|
||||||
sa.sa_handler = handleSignal; // NOLINT
|
sa.sa_handler = handleSignal; // NOLINT
|
||||||
sa.sa_flags = SA_ONSTACK;
|
sa.sa_flags = SS_ONSTACK;
|
||||||
for(std::size_t i = 0; i < DOCTEST_COUNTOF(signalDefs); ++i) {
|
for(std::size_t i = 0; i < DOCTEST_COUNTOF(signalDefs); ++i) {
|
||||||
sigaction(signalDefs[i].id, &sa, &oldSigActions[i]);
|
sigaction(signalDefs[i].id, &sa, &oldSigActions[i]);
|
||||||
}
|
}
|
||||||
|
|
Loading…
Reference in a new issue