Acoorn

Get Block

Retrieve a finalized block from the Oakspoke chain. Returns the latest block when blockNumber is omitted.

Get Balance

Get the Oakspoke balance for a GeoKey location.

Get Proof

Generate a Merkle proof for the balance at the given location.

Get State Root

Get the current canonical stateRoot from balances.json.

Get Params

Read network governance and core parameters (oakName, transactionFee, rewardInterval, etc.).

Submit Transaction

Submit a signed transaction bundle to the chain.

Health

CA health check — returns version, status, and timestamp.

Claim Location

Generate a fresh, unclaimed Oakspoke GeoKey for a new user. Random hashA/hashB identity bits and random sub-cell offsets are produced with a CSPRNG; cell coordinates are uniformly random within the map dimensions reported by /params unless x and y are supplied.

Pay

Open the Oakspoke send-payment UI as an inline app. Renders an iframe pointing at https://oakspoke.com/#send so the user can compose and submit a transaction without leaving the conversation.

Charge Card

DIRECT card charge — debit an osdebitcard and submit a signed acoorn transaction to an arbitrary destination. Use this ONLY for ad-hoc payments (e.g., paying a merchant directly). DO NOT call this after buyItem — buyItem already performs the full charge and on-chain settlement internally. Proxies to the chargeDebitCard endpoint at /chargeCard. Default memo is "🤖➡️".

Buy Item

Purchase an item from the Oakspoke General Store using an osdebitcard. This is a SINGLE TERMINAL CALL that performs the entire purchase end-to-end: it atomically claims the deliverable, debits the card, signs and submits the on-chain transaction, and returns the delivered link/code. On a 200 response the purchase is COMPLETE — do NOT call chargeCard or submitTransaction afterward. If the charge fails the claim is rolled back so nothing is lost. Use browseStore first to find sku values.

Browse Store

Browse items available for purchase in the Oakspoke General Store. Returns the public catalog (sku, title, description, price in ACN, type, stock). Does not expose codes or links — those are only delivered by buyItem after a successful charge.

Fetch

Fetch a resource by id. Supports "block:<n>", "balance:<location>", "proof:<location>", or a bare numeric block id.

Search

Heuristic search over Oakspoke resources. Numeric queries map to blocks; "X:..._Y:..." queries map to balances; otherwise returns the latest block.