Vault
Every registered vault instance operation, with source-derived inputs, outputs, access policy, and errors.
This reference covers 7 HTTP operations registered by the Akasha daemon. Call these paths on your instance base URL. See authentication, errors, and coverage before integrating.
| Method | Path | Operation |
|---|---|---|
POST | /v1/memory/vault | Memory vault store |
POST | /v1/memory/vault/get | Vault get |
POST | /v1/memory/vault/delete | Vault delete |
POST | /v1/memory/vault/search | Vault search |
GET | /v1/memory/vault/stats | Vault stats |
POST | /v1/memory/vault/update | Vault update |
POST | /v1/memory/vault/access-log | Vault access log |
POST /v1/memory/vault
Memory vault store
| Availability | Source contract |
|---|---|
| Registration | config.enable_memory |
| Runtime service | memory |
| Handler dependencies | See handler source and return expressions. |
Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.
Request
Json — VaultStoreRequest
| Field | Rust type | Required on input | Notes |
|---|---|---|---|
key | String | Yes | |
data_b64 | String | Yes | |
sensitivity | String | Yes |
struct VaultStoreRequest {
key: String,
data_b64: String,
sensitivity: 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!({"id": id})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:7575. Registration: akasha-daemon/src/main.rs:4660.
POST /v1/memory/vault/get
Vault get
| Availability | Source contract |
|---|---|
| Registration | config.enable_memory |
| Runtime service | memory |
| Handler dependencies | See handler source and return expressions. |
Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.
Request
Json — VaultGetReq
| Field | Rust type | Required on input | Notes |
|---|---|---|---|
id | String | Yes |
struct VaultGetReq {
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!({"entry": entry.map(|e| format!("{e:?}"))}),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:3783. Registration: akasha-daemon/src/main.rs:4661.
POST /v1/memory/vault/delete
Vault delete
| Availability | Source contract |
|---|---|
| Registration | config.enable_memory |
| Runtime service | memory |
| Handler dependencies | See handler source and return expressions. |
Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.
Request
Json — VaultDeleteReq
| Field | Rust type | Required on input | Notes |
|---|---|---|---|
id | String | Yes |
struct VaultDeleteReq {
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:3807. Registration: akasha-daemon/src/main.rs:4662.
POST /v1/memory/vault/search
Vault search
| Availability | Source contract |
|---|---|
| Registration | config.enable_memory |
| Runtime service | memory |
| Handler dependencies | See handler source and return expressions. |
Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.
Request
Json — VaultSearchReq
| Field | Rust type | Required on input | Notes |
|---|---|---|---|
pattern | String | Yes |
struct VaultSearchReq {
pattern: 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!({"entries": list.len()})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:3828. Registration: akasha-daemon/src/main.rs:4663.
GET /v1/memory/vault/stats
Vault stats
| Availability | Source contract |
|---|---|
| Registration | config.enable_memory |
| Runtime service | memory |
| Handler dependencies | See handler source and return expressions. |
Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.
Request
No typed JSON, query, or path extractor is declared in the handler signature. Headers or request objects may still be consumed; the signature below is authoritative.
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::to_value(stats).unwrap_or(serde_json::json!({})),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:7644. Registration: akasha-daemon/src/main.rs:4664.
POST /v1/memory/vault/update
Vault update
| Availability | Source contract |
|---|---|
| Registration | config.enable_memory |
| Runtime service | memory |
| Handler dependencies | See handler source and return expressions. |
Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.
Request
Json — VaultUpdateReq
| Field | Rust type | Required on input | Notes |
|---|---|---|---|
entry | VaultEntry | Yes |
struct VaultUpdateReq {
entry: VaultEntry,
}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:7630. Registration: akasha-daemon/src/main.rs:4665.
POST /v1/memory/vault/access-log
Vault access log
| Availability | Source contract |
|---|---|
| Registration | config.enable_memory |
| Runtime service | memory |
| Handler dependencies | See handler source and return expressions. |
Access: Daemon authentication and capability namespace authority; memory-domain permissions apply where mapped.
Request
Implementation limit: Placeholder implementation: returns an empty JSON array; backend data retrieval is not implemented here.
Json — VaultAccessLogReq
| Field | Rust type | Required on input | Notes |
|---|---|---|---|
entry_id | Option<String> | No; optional or defaulted |
struct VaultAccessLogReq {
#[allow(dead_code)]
entry_id: Option<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!([])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:10526. Registration: akasha-daemon/src/main.rs:4701.