@1claw/openapi-spec 0.38.0 → 0.39.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +1 -1
  2. package/openapi.json +52 -11
  3. package/openapi.yaml +43 -9
  4. package/package.json +2 -2
package/README.md CHANGED
@@ -87,7 +87,7 @@ import spec from "@1claw/openapi-spec/openapi.json";
87
87
  - **Smart Accounts** — Per-agent multi-chain Safe accounts: `POST /v1/agents/{id}/smart-accounts`, `GET /v1/agents/{id}` returns `smart_accounts[]`. One EOA signer per agent, Intents API resolves Safe by `chain_id`.
88
88
  - **Vaults** — CRUD, CMEK enable/disable, key rotation with job tracking, MPC enable/disable (`POST /v1/vaults/{id}/mpc`, `DELETE /v1/vaults/{id}/mpc`)
89
89
  - **Secrets** — CRUD, versioning, CMEK-encrypted flag, `client_share` in responses (MPC vaults)
90
- - **Agents** — CRUD with `auth_method` (api_key, mtls, oidc_client_credentials), auto-generated SSH keypairs, `token_ttl_seconds`, `vault_ids`, Intents API, transaction guardrails (`tx_to_allowlist`, `tx_max_value_eth`, `tx_daily_limit_eth`, `tx_allowed_chains`), **OIDC federation knobs** (`federation_enabled`, `federation_audiences`, `federated_token_ttl_seconds`); **`GET /v1/agents/{id}`** includes **`tx_spent_today_eth`** (rolling UTC-day spend from recorded txs) for clients such as **Shroud** that enforce the daily cap alongside per-tx limits
90
+ - **Agents** — CRUD with `auth_method` (api_key, mtls, oidc_client_credentials), auto-generated SSH keypairs, `token_ttl_seconds`, `vault_ids`, Intents API, transaction guardrails (`tx_to_allowlist`, `tx_max_value` (native major units), `tx_daily_limit` (per-chain), `tx_allowed_chains`), **OIDC federation knobs** (`federation_enabled`, `federation_audiences`, `federated_token_ttl_seconds`); **`GET /v1/agents/{id}`** includes **`tx_spent_today`** and **`tx_spent_today_by_chain`** (per-chain daily spend in native units) for clients such as **Shroud** that enforce the daily cap alongside per-tx limits. Deprecated aliases `tx_max_value_eth`, `tx_daily_limit_eth`, `tx_spent_today_eth` are still accepted/returned for backward compatibility.
91
91
  - **Signing Keys** — Multi-chain key management: `POST /v1/agents/{id}/signing-keys` (provision), `GET .../signing-keys` (list), `POST .../signing-keys/{chain}/rotate`, `DELETE .../signing-keys/{chain}` (deactivate). Supports ethereum, bitcoin, solana, xrp, cardano, tron
92
92
  - **Unified Signing** — `POST /v1/agents/{id}/sign` — single endpoint for EIP-191 personal_sign, EIP-712 typed_data, and EIP-2718 transaction types (legacy, EIP-1559, EIP-4844, EIP-7702)
93
93
  - **Policies** — Glob-based access control
package/openapi.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "openapi": "3.1.0",
3
3
  "info": {
4
4
  "title": "1Claw API",
5
- "version": "2.24.0",
5
+ "version": "2.25.0",
6
6
  "description": "Secure secret management for AI agents. Provides vaults, secrets,\npolicy-based access control, agent identity, Intents API,\nsharing, billing, and audit logging.\n\nAll endpoints require JWT Bearer authentication unless marked with\n`security: []`.\n",
7
7
  "contact": {
8
8
  "email": "ops@1claw.xyz"
@@ -10874,11 +10874,23 @@
10874
10874
  "type": "string"
10875
10875
  }
10876
10876
  },
10877
+ "tx_max_value": {
10878
+ "type": "string",
10879
+ "description": "Maximum value per transaction in native major units for the transacting chain family (ETH on EVM, BTC on Bitcoin, SOL on Solana, XRP, ADA, TRX)."
10880
+ },
10881
+ "tx_daily_limit": {
10882
+ "type": "string",
10883
+ "description": "Rolling daily spend cap in native major units, enforced per chain family at signing time."
10884
+ },
10877
10885
  "tx_max_value_eth": {
10878
- "type": "string"
10886
+ "type": "string",
10887
+ "deprecated": true,
10888
+ "description": "Deprecated alias for tx_max_value. Same unit semantics (native major units, not ETH-only)."
10879
10889
  },
10880
10890
  "tx_daily_limit_eth": {
10881
- "type": "string"
10891
+ "type": "string",
10892
+ "deprecated": true,
10893
+ "description": "Deprecated alias for tx_daily_limit."
10882
10894
  },
10883
10895
  "tx_allowed_chains": {
10884
10896
  "type": "array",
@@ -10941,7 +10953,7 @@
10941
10953
  "per_chain_guardrails": {
10942
10954
  "type": "object",
10943
10955
  "additionalProperties": true,
10944
- "description": "Per-chain guardrail overrides. Keys are chain family names (ethereum, bitcoin, solana, etc.).\nEach value can contain: max_value, daily_limit, to_allowlist, token_allowlist.\nExample: { \"ethereum\": { \"max_value\": \"0.5\", \"to_allowlist\": [\"0x...\"] } }\n"
10956
+ "description": "Per-chain guardrail overrides. Keys are signing chains (ethereum, bitcoin, solana, xrp, cardano, tron).\nEach value may include max_value, daily_limit, to_allowlist, token_allowlist (legacy *_eth keys accepted).\nStrictest of global and per-chain limits wins. Daily limits apply per chain family spend, not cross-chain totals.\n"
10945
10957
  },
10946
10958
  "api_key_expires_at": {
10947
10959
  "type": "string",
@@ -10979,11 +10991,23 @@
10979
10991
  "type": "string"
10980
10992
  }
10981
10993
  },
10994
+ "tx_max_value": {
10995
+ "type": "string",
10996
+ "description": "Maximum value per transaction in native major units for the transacting chain family (ETH on EVM, BTC on Bitcoin, SOL on Solana, XRP, ADA, TRX)."
10997
+ },
10998
+ "tx_daily_limit": {
10999
+ "type": "string",
11000
+ "description": "Rolling daily spend cap in native major units, enforced per chain family at signing time."
11001
+ },
10982
11002
  "tx_max_value_eth": {
10983
- "type": "string"
11003
+ "type": "string",
11004
+ "deprecated": true,
11005
+ "description": "Deprecated alias for tx_max_value. Same unit semantics (native major units, not ETH-only)."
10984
11006
  },
10985
11007
  "tx_daily_limit_eth": {
10986
- "type": "string"
11008
+ "type": "string",
11009
+ "deprecated": true,
11010
+ "description": "Deprecated alias for tx_daily_limit."
10987
11011
  },
10988
11012
  "tx_allowed_chains": {
10989
11013
  "type": "array",
@@ -11050,7 +11074,7 @@
11050
11074
  "per_chain_guardrails": {
11051
11075
  "type": "object",
11052
11076
  "additionalProperties": true,
11053
- "description": "Per-chain guardrail overrides. Keys are chain family names (ethereum, bitcoin, solana, etc.).\nEach value can contain: max_value, daily_limit, to_allowlist, token_allowlist.\nExample: { \"ethereum\": { \"max_value\": \"0.5\", \"to_allowlist\": [\"0x...\"] } }\n"
11077
+ "description": "Per-chain guardrail overrides. Keys are signing chains (ethereum, bitcoin, solana, xrp, cardano, tron).\nEach value may include max_value, daily_limit, to_allowlist, token_allowlist (legacy *_eth keys accepted).\nStrictest of global and per-chain limits wins. Daily limits apply per chain family spend, not cross-chain totals.\n"
11054
11078
  },
11055
11079
  "api_key_expires_at": {
11056
11080
  "type": "string",
@@ -11108,15 +11132,32 @@
11108
11132
  "type": "string"
11109
11133
  }
11110
11134
  },
11135
+ "tx_max_value": {
11136
+ "type": "string",
11137
+ "description": "Maximum value per transaction in native major units for the transacting chain family (ETH on EVM, BTC on Bitcoin, SOL on Solana, XRP, ADA, TRX)."
11138
+ },
11139
+ "tx_daily_limit": {
11140
+ "type": "string",
11141
+ "description": "Rolling daily spend cap in native major units, enforced per chain family at signing time."
11142
+ },
11111
11143
  "tx_max_value_eth": {
11112
- "type": "string"
11144
+ "type": "string",
11145
+ "deprecated": true,
11146
+ "description": "Deprecated alias for tx_max_value. Same unit semantics (native major units, not ETH-only)."
11113
11147
  },
11114
11148
  "tx_daily_limit_eth": {
11115
- "type": "string"
11149
+ "type": "string",
11150
+ "deprecated": true,
11151
+ "description": "Deprecated alias for tx_daily_limit."
11152
+ },
11153
+ "tx_spent_today": {
11154
+ "type": "string",
11155
+ "description": "Sum of today's spend across all chain families in major units. Prefer tx_spent_today_by_chain."
11116
11156
  },
11117
11157
  "tx_spent_today_eth": {
11118
11158
  "type": "string",
11119
- "description": "ETH value already spent today (UTC) from recorded transactions; used with daily limit guardrails"
11159
+ "deprecated": true,
11160
+ "description": "Deprecated alias for tx_spent_today."
11120
11161
  },
11121
11162
  "tx_allowed_chains": {
11122
11163
  "type": "array",
@@ -11237,7 +11278,7 @@
11237
11278
  "additionalProperties": {
11238
11279
  "type": "string"
11239
11280
  },
11240
- "description": "Per-chain-family daily spend in major units (e.g. {\"ethereum\": \"0.5\", \"solana\": \"2.1\"})."
11281
+ "description": "Per-chain-family daily spend in native major units (keys: evm, bitcoin, solana, xrp, cardano, tron)."
11241
11282
  },
11242
11283
  "api_key_expires_at": {
11243
11284
  "type": "string",
package/openapi.yaml CHANGED
@@ -2,7 +2,7 @@ openapi: 3.1.0
2
2
 
3
3
  info:
4
4
  title: 1Claw API
5
- version: 2.24.0
5
+ version: 2.25.0
6
6
  description: |
7
7
  Secure secret management for AI agents. Provides vaults, secrets,
8
8
  policy-based access control, agent identity, Intents API,
@@ -7019,10 +7019,20 @@ components:
7019
7019
  type: array
7020
7020
  items:
7021
7021
  type: string
7022
+ tx_max_value:
7023
+ type: string
7024
+ description: Maximum value per transaction in native major units for the transacting chain family (ETH on EVM, BTC on Bitcoin, SOL on Solana, XRP, ADA, TRX).
7025
+ tx_daily_limit:
7026
+ type: string
7027
+ description: Rolling daily spend cap in native major units, enforced per chain family at signing time.
7022
7028
  tx_max_value_eth:
7023
7029
  type: string
7030
+ deprecated: true
7031
+ description: Deprecated alias for tx_max_value. Same unit semantics (native major units, not ETH-only).
7024
7032
  tx_daily_limit_eth:
7025
7033
  type: string
7034
+ deprecated: true
7035
+ description: Deprecated alias for tx_daily_limit.
7026
7036
  tx_allowed_chains:
7027
7037
  type: array
7028
7038
  items:
@@ -7070,9 +7080,9 @@ components:
7070
7080
  type: object
7071
7081
  additionalProperties: true
7072
7082
  description: |
7073
- Per-chain guardrail overrides. Keys are chain family names (ethereum, bitcoin, solana, etc.).
7074
- Each value can contain: max_value, daily_limit, to_allowlist, token_allowlist.
7075
- Example: { "ethereum": { "max_value": "0.5", "to_allowlist": ["0x..."] } }
7083
+ Per-chain guardrail overrides. Keys are signing chains (ethereum, bitcoin, solana, xrp, cardano, tron).
7084
+ Each value may include max_value, daily_limit, to_allowlist, token_allowlist (legacy *_eth keys accepted).
7085
+ Strictest of global and per-chain limits wins. Daily limits apply per chain family spend, not cross-chain totals.
7076
7086
  api_key_expires_at:
7077
7087
  type: string
7078
7088
  format: date-time
@@ -7099,10 +7109,20 @@ components:
7099
7109
  type: array
7100
7110
  items:
7101
7111
  type: string
7112
+ tx_max_value:
7113
+ type: string
7114
+ description: Maximum value per transaction in native major units for the transacting chain family (ETH on EVM, BTC on Bitcoin, SOL on Solana, XRP, ADA, TRX).
7115
+ tx_daily_limit:
7116
+ type: string
7117
+ description: Rolling daily spend cap in native major units, enforced per chain family at signing time.
7102
7118
  tx_max_value_eth:
7103
7119
  type: string
7120
+ deprecated: true
7121
+ description: Deprecated alias for tx_max_value. Same unit semantics (native major units, not ETH-only).
7104
7122
  tx_daily_limit_eth:
7105
7123
  type: string
7124
+ deprecated: true
7125
+ description: Deprecated alias for tx_daily_limit.
7106
7126
  tx_allowed_chains:
7107
7127
  type: array
7108
7128
  items:
@@ -7162,9 +7182,9 @@ components:
7162
7182
  type: object
7163
7183
  additionalProperties: true
7164
7184
  description: |
7165
- Per-chain guardrail overrides. Keys are chain family names (ethereum, bitcoin, solana, etc.).
7166
- Each value can contain: max_value, daily_limit, to_allowlist, token_allowlist.
7167
- Example: { "ethereum": { "max_value": "0.5", "to_allowlist": ["0x..."] } }
7185
+ Per-chain guardrail overrides. Keys are signing chains (ethereum, bitcoin, solana, xrp, cardano, tron).
7186
+ Each value may include max_value, daily_limit, to_allowlist, token_allowlist (legacy *_eth keys accepted).
7187
+ Strictest of global and per-chain limits wins. Daily limits apply per chain family spend, not cross-chain totals.
7168
7188
  api_key_expires_at:
7169
7189
  type: string
7170
7190
  format: date-time
@@ -7206,13 +7226,27 @@ components:
7206
7226
  type: array
7207
7227
  items:
7208
7228
  type: string
7229
+ tx_max_value:
7230
+ type: string
7231
+ description: Maximum value per transaction in native major units for the transacting chain family (ETH on EVM, BTC on Bitcoin, SOL on Solana, XRP, ADA, TRX).
7232
+ tx_daily_limit:
7233
+ type: string
7234
+ description: Rolling daily spend cap in native major units, enforced per chain family at signing time.
7209
7235
  tx_max_value_eth:
7210
7236
  type: string
7237
+ deprecated: true
7238
+ description: Deprecated alias for tx_max_value. Same unit semantics (native major units, not ETH-only).
7211
7239
  tx_daily_limit_eth:
7212
7240
  type: string
7241
+ deprecated: true
7242
+ description: Deprecated alias for tx_daily_limit.
7243
+ tx_spent_today:
7244
+ type: string
7245
+ description: Sum of today's spend across all chain families in major units. Prefer tx_spent_today_by_chain.
7213
7246
  tx_spent_today_eth:
7214
7247
  type: string
7215
- description: ETH value already spent today (UTC) from recorded transactions; used with daily limit guardrails
7248
+ deprecated: true
7249
+ description: Deprecated alias for tx_spent_today.
7216
7250
  tx_allowed_chains:
7217
7251
  type: array
7218
7252
  items:
@@ -7304,7 +7338,7 @@ components:
7304
7338
  type: object
7305
7339
  additionalProperties:
7306
7340
  type: string
7307
- description: 'Per-chain-family daily spend in major units (e.g. {"ethereum": "0.5", "solana": "2.1"}).'
7341
+ description: 'Per-chain-family daily spend in native major units (keys: evm, bitcoin, solana, xrp, cardano, tron).'
7308
7342
  api_key_expires_at:
7309
7343
  type: string
7310
7344
  format: date-time
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@1claw/openapi-spec",
3
- "version": "0.38.0",
4
- "description": "OpenAPI 3.1.0 specification for the 1Claw Vault API — generate clients in any language",
3
+ "version": "0.39.0",
4
+ "description": "OpenAPI 3.1.0 specification for the 1Claw Vault API \u2014 generate clients in any language",
5
5
  "license": "MIT",
6
6
  "repository": {
7
7
  "type": "git",