Transactions
Every registered transactions instance operation, with source-derived inputs, outputs, access policy, and errors.
This reference covers 3 HTTP operations registered by the Akasha daemon. Call these paths on your instance base URL. See authentication, errors, and coverage before integrating.
POST /v1/tx/begin
Tx begin
| Availability | Source contract |
|---|---|
| Registration | config.enable_kv |
| Runtime service | No prefix-level service check; handler dependencies still apply. |
| Handler dependencies | See handler source and return expressions. |
Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.
Request
Json — TxBeginReq
| Field | Rust type | Required on input | Notes |
|---|---|---|---|
actor | String | Yes | |
isolation | String | Yes |
struct TxBeginReq {
actor: String,
isolation: String,
}Response
Declared return: Result<impl IntoResponse, DaemonError>
The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.
serde_json::json!({"tx_id": tx_id.to_string()})Errors and validation
Directly referenced error variants: none in the handler body. Middleware and delegated services can return additional errors described in the shared error reference.
Source: akasha-daemon/src/main.rs:3398. Registration: akasha-daemon/src/main.rs:4581.
POST /v1/tx/commit
Tx commit
| Availability | Source contract |
|---|---|
| Registration | config.enable_kv |
| Runtime service | No prefix-level service check; handler dependencies still apply. |
| Handler dependencies | See handler source and return expressions. |
Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.
Request
Json — TxIdReq
| Field | Rust type | Required on input | Notes |
|---|---|---|---|
id | String | Yes |
struct TxIdReq {
id: String,
}Response
Declared return: Result<impl IntoResponse, DaemonError>
The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.
serde_json::json!({"ok": true})Errors and validation
Directly referenced error variants: InvalidRequest. Middleware and delegated services can return additional errors described in the shared error reference.
Source: akasha-daemon/src/main.rs:3424. Registration: akasha-daemon/src/main.rs:4582.
POST /v1/tx/abort
Tx abort
| Availability | Source contract |
|---|---|
| Registration | config.enable_kv |
| Runtime service | No prefix-level service check; handler dependencies still apply. |
| Handler dependencies | See handler source and return expressions. |
Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.
Request
Json — TxIdReq
| Field | Rust type | Required on input | Notes |
|---|---|---|---|
id | String | Yes |
struct TxIdReq {
id: String,
}Response
Declared return: Result<impl IntoResponse, DaemonError>
The following are the exact JSON construction expressions in the handler. Values such as rows, result, and delegated types are runtime values, not literal example payloads.
serde_json::json!({"ok": true})Errors and validation
Directly referenced error variants: InvalidRequest. Middleware and delegated services can return additional errors described in the shared error reference.
Source: akasha-daemon/src/main.rs:3442. Registration: akasha-daemon/src/main.rs:4583.