Build apps on STRATO

Cirrus is a read-only PostgREST API over every contract on chain. No key, no login.

H=https://app.testnet.strato.nexus/cirrus/search

# Token metadata for USDST
curl -s "$H/BlockApps-Token?address=eq.937efa7e3a77e20bbdbd7c0d32b6514f368c1010&select=_name,_symbol,customDecimals"

# A user's USDST balance (a mapping is its own table: address, key, value)
curl -s "$H/BlockApps-Token-_balances?address=eq.937efa7e3a77e20bbdbd7c0d32b6514f368c1010&key=eq.<user>&select=value::text"

# Gold and silver prices from the platform oracle (USD x 1e18)
curl -s "$H/BlockApps-PriceOracle-prices?address=eq.0000000000000000000000000000000000001002&key=in.(cdc93d30182125e05eec985b631c7c61b3f63ff0,2c59ef92d08efde71fe1a1cb5b45f4f6d48fcc94)&select=asset:key,price:value::text"

For scripts, bots and backend jobs: a client-credentials token from Keycloak. Request a client at support.blockapps.net.

import axios from "axios"

const DISCOVERY =
  "https://keycloak.blockapps.net/auth/realms/mercata/.well-known/openid-configuration"

export async function getAccessToken(): Promise<string> {
  const { data: oidc } = await axios.get(DISCOVERY)
  const { data } = await axios.post(
    oidc.token_endpoint,
    new URLSearchParams({ grant_type: "client_credentials" }),
    { auth: { username: process.env.OAUTH_CLIENT_ID!, password: process.env.OAUTH_CLIENT_SECRET! } },
  )
  return data.access_token
}

Call any contract function by name. Batch the approve with the action so the user confirms once. Each tx in the batch costs 0.01 USDST.

import axios from "axios" // not fetch: Node's fetch User-Agent fails the node's CSRF check

const BLOC = "https://app.testnet.strato.nexus/bloc/v2.2"
type Call = { contractName: string; contractAddress: string; method: string; args: Record<string, unknown> }

export async function submit(token: string, calls: Call[]) {
  const { data } = await axios.post(
    `${BLOC}/transaction/parallel?resolve=true`,
    {
      txs: calls.map((payload) => ({ type: "FUNCTION", payload })),
      txParams: { gasLimit: 32_100_000_000, gasPrice: 1 }, // fixed values; they don't change the fee
    },
    { headers: { Authorization: `Bearer ${token}` } },
  )
  return waitForResults(data.map((r: { hash: string }) => r.hash))
}

async function waitForResults(hashes: string[], timeoutMs = 45_000) {
  const start = Date.now()
  for (;;) {
    const { data } = await axios.post(`${BLOC}/transactions/results`, hashes)
    const failed = data.find((r: any) => r.status === "Failure")
    if (failed) throw new Error(failed.txResult?.message ?? "Transaction failed")
    if (data.every((r: any) => r.status === "Success")) return data
    if (Date.now() - start > timeoutMs) throw new Error("Submitted, not confirmed yet") // Pending is never success
    await new Promise((r) => setTimeout(r, 1500))
  }
}

// STRATO Odds' "split": approve USDST, then call the market. Addresses: 40 hex, no 0x.
await submit(token, [
  { contractName: "Token", contractAddress: USDST, method: "approve", args: { spender: market, value: amount } },
  { contractName: "Market", contractAddress: market, method: "split", args: { amount } },
])