Deposit and withdrawal reconciliation

Deposits and withdrawals reconcile across three surfaces:

Onchain vault event.
OMS account-activity event.
Inventory delta from GET /inventory/user/{user_id}.

Deposit join keys

Vault deposit events include user, nonce, token address, and amount. OMS account activity emits:

{
  "DepositLanded": {
    "user": "<user public key>",
    "asset": "200",
    "amount": "1000000000000000000",
    "chain_id": "<chain id>",
    "deposit_nonce": 12,
    "timestamp_ns": 1760000000000000000
  }
}

Stable join key: (user, chain_id, deposit_nonce). Compare the account event amount against the inventory delta in 18-decimal internal units. Use the registry decimals to convert onchain token base units to internal units. Raw reconciliation:

curl -H "Authorization: Bearer $TOKEN" -H "User-Id: $USER_ID" \
  https://oms.tplus.cx/inventory/user/$USER_ID

wss://oms.tplus.cx/account/events/<user_id>

Withdrawal join keys

A withdrawal starts with POST /withdrawal/init, enters GET /withdrawal/queue/{user_id}, receives quorum approvals, then the user submits withdraw(...) on the vault. Completion emits:

{
  "WithdrawalCompleted": {
    "user": "<user public key>",
    "asset": "200",
    "amount": "1000000000000000000",
    "chain_id": "<chain id>",
    "withdrawal_nonce": 7,
    "timestamp_ns": 1760000000000000000
  }
}

Stable join key: (user, chain_id, withdrawal_nonce). The vault call carries token address, amount, nonce, target, validUntil, epochHash, and approval signatures; get exact fields from the live OMS reference and Deposit Vault.

tpluspy

from tplus.client import OrderBookClient

async with OrderBookClient(user=user, base_url="https://oms.tplus.cx") as oms:
    before = await oms.get_user_inventory()
    async for event in oms._stream_ws(f"/account/events/{user.public_key}", lambda data: data):
        after = await oms.get_user_inventory()
        reconcile(before, event, after)
        before = after

    queued = await oms._request("GET", f"/withdrawal/queue/{user.public_key}")

If a submission times out, do not assume failure. Read the queue, account events, and inventory before retrying with a new nonce.

Getting Started

Integration guides

Deposit and withdrawal reconciliation

Deposit join keys

Withdrawal join keys

tpluspy

​Deposit join keys

​Withdrawal join keys

​tpluspy

Deposit join keys

Withdrawal join keys

tpluspy