HYBRID-CHAINDEVELOPERS

DOCUMENTATIONv2

OPERATE · MODULE 06

Funding

Observe owner-scoped deposits and exceptions, prepare wallet funding routes, and coordinate exact-intent settlement lifecycles across consent, custody, collateral, broadcast, finality, and reconciliation boundaries without making the gateway a value owner.

BUSINESS CASES

Where this module fits

deposit monitoring
wallet funding-route preparation
withdrawal and same-network transfer intent planning
multi-factor exact-intent customer consent
pre-broadcast cancellation and collateral release
settlement reconciliation

PRIMARY CONSUMERS

Who integrates it

treasury teams
payment operations
reconciliation agents

PREREQUISITES

What must exist first

an authenticated owner and matching network context
an active owner-scoped MPC wallet activation for route or intent mutations
rail-specific compliance, native-asset, custody, collateral, and finality readiness

RECOMMENDED WORKFLOW

Compose the module safely.

01
discover linked instruments, wallet activation, and funding readiness
02
prepare a non-value-bearing route and observe deposits
03
create an exact settlement intent and complete its three-phase consent ceremony
04
observe separate authorization, collateral, signing, broadcast, and finality states
05
reconcile exceptions, cancellation, and retained evidence

AGENT INTEGRATION

Machine-use boundaries

Treat PREPARED bindings, observed deposits, accepted intents, completed consent, collateral reservation, and broadcast as distinct states; none substitutes for final settlement evidence.
Preserve amounts as exact decimal strings, re-fetch network and native-asset policy, and never derive owner, wallet, or destination authority from presentation data.
Use one Idempotency-Key only for a byte-equivalent logical mutation and reconcile owner state before retrying an ambiguous response.
Never send passwords, private keys, seeds, MPC shares, signing nonces, raw bank coordinates, or credential secrets through Funding contracts.
Planned Funding mutations remain non-executable until they appear in production OpenAPI; current production non-zero value movement and all trading or matching authority remain fail closed.

Register only production-listed routes as executable tools, and re-fetch the deployed OpenAPI before generating or sending a request. Source-ready routes awaiting deployment are preparation references; planned contracts are non-executable.

MODULE CONTRACTS

Every mapped endpoint

Each operation states whether its request shape is authoritative in OpenAPI, reviewed as a planning profile, or intentionally left as an outline pending an owner schema.

GETList linked bank accounts/api/v2/funding/bank-accountsReturn the authenticated profile's linked bank accounts with opaque identifiers, masked IBANs, currencies, and verification state; full account numbers and legacy database identifiers are excluded.›GETGet additional funding options link/api/v2/wallet/additional_deposit_options_linkPlanned capability: list additional funding options link through the authoritative custody service boundary.›GETGet crypto deposit pubkeys/api/v2/wallet/depositPlanned capability: list crypto deposit pubkeys through the authoritative custody service boundary.›GETGet funding rates/api/v2/markets/{market_id}/funding-ratesReturn the configured funding rate for a perpetual market.›GETGet mtf funding rates/api/v2/exchange/fundingratesPlanned capability: list mtf funding rates through the authoritative market and trading service boundary.›POSTReconcile market delivery/api/v2/asset-market-orders/{order_uuid}/reconciliationsPlanned capability: verify one Commerce-owned payment confirmation against an asset-market order and, only when every immutable term matches, request atomic delivery of the order's reserved items.›POSTRun reconciliation/api/v2/admin/billing/reconciliationsPlanned capability: request an idempotent restricted billing reconciliation.›GETList network bindings/api/v2/funding/bindingsReturn owner-scoped funding route bindings and their preparation or activation posture without exposing wallet addresses, keys, or custody material.›POSTPrepare binding/api/v2/funding/bindingsPrepare an owner-scoped wallet activation binding for one network, chain, and currency; the resulting PREPARED route cannot receive credit or activate value movement.›GETList deposits/api/v2/funding/depositsList the authenticated owner's newest observed deposits, confirmation progress, reserve commitments, exact decimal amounts, retained first-observed valuation, and credit-availability lifecycle without exposing owner IDs, wallet IDs, or native addresses.›GETGet positions/api/v2/funding/positionsReturn balances, bindings, deposits, and settlement posture for the active network.›GETGet operational readiness/api/v2/funding/readinessReturn fail-closed funding readiness evidence without authorizing activation.›GETList reconciliation incidents/api/v2/funding/reconciliation-incidentsList the authenticated owner's newest funding reconciliation exceptions, reason and resolution codes, event identifiers, and evidence commitments through a read-only projection that never changes balances.›GETList settlement intents/api/v2/funding/settlement-intentsList owner-scoped settlement intents and their current authorization, reservation, signing, broadcast, and finality posture without granting authority to advance them.›POSTCreate settlement intent/api/v2/funding/settlement-intentsCreate an owner-scoped withdrawal or internal-transfer intent in AUTHORIZATION_REQUIRED state; creation neither reserves collateral nor signs, broadcasts, or moves funds.›GETGet settlement intent/api/v2/funding/settlement-intents/{intent_uuid}Return the complete state and evidence for one settlement intent.›POSTCancel settlement intent/api/v2/funding/settlement-intents/{intent_uuid}/cancellationsAtomically cancel an owner-scoped pre-broadcast settlement intent and release any held collateral; signing, broadcast, and terminal states remain outside customer cancellation authority.›POSTComplete settlement consent/api/v2/funding/settlement-intents/{intent_uuid}/consentAdvance the exact-intent customer-consent ceremony through challenge, native-plus-passkey preauthorization, and OPAQUE receipt completion without accepting a password or authorizing broadcast.›GETGet compose the funding evidence dashboard/api/v2/explorer/fundingPlanned capability: planning marker for the Explorer website's funding dashboard composition. It is not an aggregate API endpoint: clients assemble the view from the implemented funding operations, bindings, deposits, settlement intents, integrity audit, acceptance certificates and authorities, activation governance, escrow positions, and shadow observations reads.›GETGet funding record/api/v2/explorer/funding/{identifier}Return funding identifier from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETList funding acceptance authorities/api/v2/explorer/funding/acceptance-authoritiesList funding acceptance authorities from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETGet funding acceptance authority/api/v2/explorer/funding/acceptance-authorities/{authority_identifier}Return funding acceptance authority from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETGet funding acceptance authority/api/v2/explorer/funding/acceptance-authorities/{identifier}Return funding acceptance authorities identifier from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETList funding acceptance certificates/api/v2/explorer/funding/acceptance-certificatesList funding acceptance certificates from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETGet funding acceptance certificate/api/v2/explorer/funding/acceptance-certificates/{acceptance_identifier}Return funding acceptance certificate from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETGet funding acceptance/api/v2/explorer/funding/acceptance/{identifier}Return funding acceptance identifier from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETGet funding activation governance/api/v2/explorer/funding/activation-governanceList funding activation governance from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETGet funding activation policy/api/v2/explorer/funding/activation-governance/{policy_identifier}Return the current public posture for funding activation policy from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETList funding bindings/api/v2/explorer/funding/bindingsList funding bindings from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETGet funding binding/api/v2/explorer/funding/bindings/{binding_identifier}Return funding binding from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETList funding deposits/api/v2/explorer/funding/depositsList funding deposits from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETGet funding deposit/api/v2/explorer/funding/deposits/{deposit_identifier}Return funding deposit from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETList funding escrow positions/api/v2/explorer/funding/escrow-positionsList funding escrow positions from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETGet funding escrow position/api/v2/explorer/funding/escrow-positions/{position_identifier}Return funding escrow position from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETGet funding escrow/api/v2/explorer/funding/escrow/{identifier}Return funding escrow identifier from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETGet funding integrity audit/api/v2/explorer/funding/integrity-auditReturn the verification projection for funding integrity audit from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETGet funding observation/api/v2/explorer/funding/observations/{identifier}Return funding observations identifier from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETList funding operations/api/v2/explorer/funding/operationsReturn the ordered public record for funding operations from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETGet funding route/api/v2/explorer/funding/routes/{identifier}Return funding routes identifier from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETList funding settlement intents/api/v2/explorer/funding/settlement-intentsList funding settlement intents from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETGet funding settlement intent/api/v2/explorer/funding/settlement-intents/{intent_identifier}Return funding settlement intent from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETGet funding settlement/api/v2/explorer/funding/settlements/{identifier}Return funding settlements identifier from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETList funding shadow observations/api/v2/explorer/funding/shadow-observationsList funding shadow observations from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETGet funding shadow observation/api/v2/explorer/funding/shadow-observations/{shadow_observation_identifier}Return funding shadow observation from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETGet funding source observer tip/api/v2/explorer/funding/source-observers/{observer_key_id}/tipReturn the current public posture for funding source observer tip from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›