Implement anonymous mode (#493)

Author: zupzup

.cargo/config.toml

@@ -1,7 +1,7 @@
 /target
 /contacts/*
 /esplora/.docker_data/
-data/
+./data/
 /frontend_build/*
 /identity/*
 /bills/*

.gitignore

@@ -1,3 +1,42 @@
+# 0.3.11
+
+* Add LICENSE to crates
+* Remove the `bcr-ebill-web` crate
+* Use a list of Nostr relays everywhere, instead of a single one, including in the config
+* Add Blank Endorse Bill data model implementation
+    * Rename `IdentityPublicData` to `BillIdentParticipant`
+        * same for `LightIdentityPublicData`
+    * Introduce the concept of `BillParticipant`, with the variants `Ident` and `Anon`
+        * `Anon` includes a `BillAnonParticipant`
+        * `Ident` includes a `BillIdentParticipant`
+    * Use `BillParticipant` in parts of the bill where a participant can be anonymous
+* Add the possibility to add anonymous contacts
+    * They only have Node Id, Name and E-Mail as fields
+    * E-Mail is optional
+    * This changes the data model for contacts, `email` and `postal_address` are now optional
+        * Additional validation rules ensure the fields can only be set for non-anon contacts
+    * Adds an endpoint `Api.contact().deanonymize()` to de-anonymize a contact by adding all necessary fields for a personal, or company contact
+        * It takes the same payload as creating a contact and fails for non-anon contacts
+* Add the possibility to add an anonymous identity
+    * They only have Node Id, (nick)name and E-Mail as fields
+    * E-Mail is optional
+    * Adds an endpoint `Api.identity().deanonymize()` to de-anonymize an identity by adding all necessary fields for a personal identity
+        * It takes the same payload as creating an identity and fails for a non-anon identity
+    * Anon identity can't issue bills, or create a company
+* Add the possibility to issue and endorse blank
+    * New `Api.bill()` methods for blank endorsements
+      * `issue_blank`
+      * `offer_to_sell_blank`
+      * `endorse_bill_blank`
+      * `mint_bill_blank`
+    * Can issue (non-self-drafted) blank bills (payee is anon)
+    * Can endorse/mint/offer to sell to anon endorsee/mint/buyer
+    * If caller of a bill action is anonymous in the bill, any action they take stay anonymous (e.g. endorse)
+* Add endpoint to check payment for singular bill
+    * `Api.bill().check_payment_for_bill(id)`
+* Fix TS type for identity detail
+* Return identity on `create` and `deanonymize` identity for consistency
+
 # 0.3.10
 
 * Change default testnet block explorer to `https://esplora.minibill.tech`

CHANGELOG.md

@@ -1,11 +1,10 @@
 [workspace]
 resolver = "3"
 members = [
-  "crates/bcr-ebill-web",
   "crates/bcr-ebill-core",
-  "crates/bcr-ebill-api",
   "crates/bcr-ebill-persistence",
   "crates/bcr-ebill-transport",
+  "crates/bcr-ebill-api",
   "crates/bcr-ebill-wasm",
 ]
 
@@ -33,15 +32,14 @@ serde_repr = "0.1"
 futures = { version = "0.3", default-features = false }
 anyhow = { version = "1", default-features = false }
 thiserror = { version = "2", default-features = false }
-lazy_static = "1.5"
 uuid = { version = "1", default-features = false, features = ["v4", "js"] }
 bitcoin = { version = "0.32", default-features = false }
 bip39 = { version = "2.1", features = ["rand"] }
 ecies = { version = "0.2", default-features = false, features = ["pure"] }
 nostr = { version = "0.40"}
 nostr-sdk = { version = "0.40", features = ["nip04", "nip59"] }
 getrandom = { version = "0.3.1", features = ["wasm_js"] }
-reqwest = { version = "0.12", default-features = false, features = ["json"] }
 async-broadcast = "0.7.2"
 rstest = "0.25.0"
 secp256k1 = { version = "0.29" }
+reqwest = { version = "0.12", default-features = false }

Cargo.toml

@@ -8,14 +8,13 @@ The project consists of the following crates:
 
 * `bcr-ebill-core` - core data models and traits
 * `bcr-ebill-persistence` - persistence traits and SurrealDB implementation
-* `bcr-ebill-transport` - network transport traits and Nostr implementation
+* `bcr-ebill-transport` - network transport API traits and Nostr implementation
 * `bcr-ebill-api` - API of the E-Bills project, contains most of the business logic
-* `bcr-ebill-web` - Entrypoint for Web applications using the Rocket web server
 * `bcr-ebill-wasm` - Entrypoint for WASM version of the E-Bill API
 
-### Entrypoints
+### Entrypoint
 
-There are both `WASM` and `Web` entry points into the API. You can find the documentation to build and configure them [here](docs/index.md):
+There is a `WASM` entry point into the API. You can find the documentation to build and configure it [here](docs/index.md):
 
 ### Tests
 

Dockerfile

@@ -1,6 +1,6 @@
 [package]
 name = "bcr-ebill-api"
-version = "0.3.10"
+version = "0.3.11"
 edition = "2024"
 license = "MIT"
 
@@ -22,14 +22,19 @@ uuid.workspace = true
 bitcoin.workspace = true
 nostr-sdk.workspace = true
 futures.workspace = true
-reqwest.workspace = true
 infer = { version = "0.19.0", default-features = false }
 bcr-ebill-core = { path = "../bcr-ebill-core" }
 bcr-ebill-persistence = { path = "../bcr-ebill-persistence" }
 bcr-ebill-transport = { path = "../bcr-ebill-transport" }
 tokio.workspace = true
 tokio_with_wasm.workspace = true
 
+[target.'cfg(target_arch = "wasm32")'.dependencies]
+reqwest = { workspace = true, features = ["json"] }
+
+[target.'cfg(not(target_arch = "wasm32"))'.dependencies]
+reqwest = { workspace = true, features = ["default", "json"] }
+
 [dev-dependencies]
 mockall = "0.13.1"
 nostr-relay-builder = "0.40"

README.md

@@ -24,8 +24,8 @@ pub use persistence::notification::NotificationFilter;
 pub struct Config {
     pub bitcoin_network: String,
     pub esplora_base_url: String,
-    pub nostr_relay: String,
-    pub surreal_db_connection: String,
+    pub nostr_relays: Vec<String>,
+    pub db_config: SurrealDbConfig,
     pub data_dir: String,
 }
 

crates/bcr-ebill-api/Cargo.toml

@@ -2,8 +2,8 @@ use crate::Config;
 use bcr_ebill_persistence::{
     BackupStoreApi, ContactStoreApi, NostrEventOffsetStoreApi, NotificationStoreApi,
     SurrealBackupStore, SurrealBillChainStore, SurrealBillStore, SurrealCompanyChainStore,
-    SurrealCompanyStore, SurrealContactStore, SurrealDbConfig, SurrealIdentityChainStore,
-    SurrealIdentityStore, SurrealNostrEventOffsetStore, SurrealNotificationStore,
+    SurrealCompanyStore, SurrealContactStore, SurrealIdentityChainStore, SurrealIdentityStore,
+    SurrealNostrEventOffsetStore, SurrealNotificationStore,
     bill::{BillChainStoreApi, BillStoreApi},
     company::{CompanyChainStoreApi, CompanyStoreApi},
     db::nostr_send_queue::SurrealNostrEventQueueStore,
@@ -46,8 +46,7 @@ pub struct DbContext {
 
 /// Creates a new instance of the DbContext with the given SurrealDB configuration.
 pub async fn get_db_context(conf: &Config) -> bcr_ebill_persistence::Result<DbContext> {
-    let surreal_db_config = SurrealDbConfig::new(&conf.surreal_db_connection);
-    let db = get_surreal_db(&surreal_db_config).await?;
+    let db = get_surreal_db(&conf.db_config).await?;
 
     let company_store = Arc::new(SurrealCompanyStore::new(db.clone()));
     #[cfg(target_arch = "wasm32")]