Tokenized Assets

import httpx

OWNER = "0xYourOwnerAddress"

create = httpx.post(
    "https://api.compasslabs.ai/v2/tokenized_assets/create_account",
    json={"sender": OWNER, "owner": OWNER},   # add "chain": "base" | "bsc" for Midas / IXS
    headers={"x-api-key": "YOUR_API_KEY"},
).json()

account = create["tokenized_assets_account_address"]
if create["transaction"] is not None:
    # Sign and broadcast create["transaction"] with the owner's wallet, then cache the address.
    ...

const ownerAddress = "0xYourOwnerAddress";

const create = await fetch(
  "https://api.compasslabs.ai/v2/tokenized_assets/create_account",
  {
    method: "POST",
    headers: { "Content-Type": "application/json", "x-api-key": "YOUR_API_KEY" },
    body: JSON.stringify({ sender: ownerAddress, owner: ownerAddress }),
  },
).then((r) => r.json());

const account = create.tokenized_assets_account_address;
if (create.transaction) {
  // Sign and broadcast create.transaction with the owner's wallet, then cache the address.
}

build = httpx.post(
    "https://api.compasslabs.ai/v2/tokenized_assets/order",
    json={
        "from_token": "USDC",       # symbol or 0x-prefixed Ethereum address
        "to_token": "TSLAon",
        "amount": "100",            # 100 USDC; decimals applied server-side
        "owner": OWNER,
        "slippage_bps": 50,         # 0.5% (range 1–1000, max 10%)
    },
    headers={"x-api-key": "YOUR_API_KEY"},
).json()

quote = build["quote"]
approval = build["approval_safe_tx_eip712"]   # None once the token is approved
order = build["order"]

const build = await fetch(
  "https://api.compasslabs.ai/v2/tokenized_assets/order",
  {
    method: "POST",
    headers: { "Content-Type": "application/json", "x-api-key": "YOUR_API_KEY" },
    body: JSON.stringify({
      from_token: "USDC",
      to_token: "TSLAon",
      amount: "100",
      owner: ownerAddress,
      slippage_bps: 50,
    }),
  },
).then((r) => r.json());

const { quote, approval_safe_tx_eip712: approval, order } = build;

import { createWalletClient, custom } from "viem";

const wallet = createWalletClient({ transport: custom(window.ethereum) });

let approvalSignature: `0x${string}` | undefined;
if (approval) {
  approvalSignature = await wallet.signTypedData({
    account: ownerAddress,
    domain: approval.domain,
    types: approval.types,
    primaryType: approval.primaryType,   // "SafeTx"
    message: approval.message,
  });
}

if approval is not None:
    prep = httpx.post(
        "https://api.compasslabs.ai/v2/gas_sponsorship/prepare",
        json={
            "chain": "ethereum",
            "product": "tokenized_assets",
            "owner": OWNER,
            "sender": SPONSOR,          # pays gas; can be the owner
            "eip_712": approval,
            "signature": approval_signature,
        },
        headers={"x-api-key": "YOUR_API_KEY"},
    ).json()
    # prep["transaction"] is an unsigned execTransaction — sign with sender's key and broadcast.

const orderSignature = await wallet.signTypedData({
  account: ownerAddress,
  domain: order.safe_message_eip712.domain,
  types: order.safe_message_eip712.types,
  primaryType: order.safe_message_eip712.primaryType,   // "SafeMessage"
  message: order.safe_message_eip712.message,           // { message: "0x<orderHash>" }
});

submit = httpx.post(
    "https://api.compasslabs.ai/v2/tokenized_assets/order/submit",
    json={
        "signed_order": order["order_message"],   # maker is the account — pass back unchanged
        "signature": order_signature,
        "extension": order["extension"],           # opaque — pass back unchanged
        "quote_id": order["quote_id"],             # opaque — pass back unchanged
        "order_hash": order["order_hash"],         # recommended
    },
    headers={"x-api-key": "YOUR_API_KEY"},
).json()

order_hash = submit["order_hash"]