v11

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-023710598.2 KB

Wallets

Derive (and persist) a smart wallet address from (owner, salt, factory)

Idempotent "ensure exists". Returns the deterministic CREATE2-derived address. POST (not GET) because it persists a wallet record server-side as a side effect of the derivation.

post/wallets

Request body

saltstring required

Salt as a decimal string (big-int). Determines the derived address together with the factory.

factoryAddressstring

Lowercase or checksummed hex EOA / contract address.

chainIdinteger

Numeric chain ID (e.g. 11155111 for Sepolia, 8453 for Base). On chain-aware trigger/node configs this is required and must be a configured chain; on query/filter params it is optional.

Example request

{
  "factoryAddress": "0x82F2Dd9a552a69f2ceD7Ff2D05c43aB8430158FB",
  "chainId": 11155111
}

Response

Wallet derived (existing record returned if already present).

addressstring required

Lowercase or checksummed hex EOA / contract address.

saltstring required

Salt used in CREATE2 derivation (decimal string).

factoryAddressstring

Lowercase or checksummed hex EOA / contract address.

isHiddenboolean

totalWorkflowCountinteger

enabledWorkflowCountinteger

completedWorkflowCountinteger

failedWorkflowCountinteger

disabledWorkflowCountinteger

Example response

{
  "address": "0x82F2Dd9a552a69f2ceD7Ff2D05c43aB8430158FB",
  "factoryAddress": "0x82F2Dd9a552a69f2ceD7Ff2D05c43aB8430158FB"
}