mirror of
https://github.com/tursodatabase/libsql.git
synced 2024-11-23 21:26:15 +00:00
29 lines
2.6 KiB
Markdown
29 lines
2.6 KiB
Markdown
# SQLite3MultipleCiphers
|
|
|
|
The project **SQLite3 Multiple Ciphers** implements an encryption extension for [SQLite](https://www.sqlite.org) with support for multiple ciphers. In the past the encryption extension was bundled with the project [wxSQLite3](https://github.com/utelle/wxsqlite3), which provides a thin SQLite3 database wrapper for [wxWidgets](https://www.wxwidgets.org/).
|
|
|
|
In the course of time several developers had asked for a stand-alone version of the _wxSQLite3 encryption extension_. Originally it was planned to undertake the separation process already in 2019, but due to personal matters it had to be postponed for several months. However, maybe that wasn't that bad after all, because there were changes to the public SQLite code on Feb 7, 2020: [“Simplify the code by removing the unsupported and undocumented SQLITE_HAS_CODEC compile-time option”](https://www.sqlite.org/src/timeline?c=5a877221ce90e752). These changes took effect with the release of SQLite version 3.32.0 on May 22, 2020. As a consequence, all SQLite encryption extensions out there will not be able to easily support SQLite version 3.32.0 and later.
|
|
|
|
In late February 2020 work started on a new implementation of a SQLite encryption extension that will be able to support SQLite 3.32.0 and later. The new approach is based on [SQLite's VFS feature](https://www.sqlite.org/vfs.html). This approach has its pros and cons. On the one hand, the code is less closely coupled with SQLite itself; on the other hand, access to SQLite's internal data structures is more complex.
|
|
|
|
The code was mainly developed under Windows, but was tested under Linux as well. At the moment no major issues are known.
|
|
|
|
## Version information
|
|
|
|
* 1.8.1 - *December 2023*
|
|
- Based on SQLite version 3.44.2
|
|
- Fixed issue #133 - missing API symbols
|
|
- Applied several modifications to improve support for [SQLite3 WASM](https://sqlite.org/wasm/)
|
|
|
|
For further version information please consult the [CHANGELOG](CHANGELOG.md).
|
|
|
|
## How to participate
|
|
|
|
**Help in testing and discussing further development will be _highly_ appreciated**. Please use the [issue tracker](https://github.com/utelle/SQLite3MultipleCiphers/issues) to give feedback, report problems, or to discuss ideas.
|
|
|
|
## Documentation
|
|
|
|
Documentation of the currently supported cipher schemes and the C and SQL interfaces is provided on the [SQLite3 Multiple Ciphers website](https://utelle.github.io/SQLite3MultipleCiphers/).
|
|
|
|
Documentation on how to build the extension can be found on the page [SQLite3 Multiple Ciphers Installation](https://utelle.github.io/SQLite3MultipleCiphers/docs/installation/install_overview/).
|