Errors

{
  "error": "tier_insufficient",
  "message": "Method 'getAssetsByOwner' requires basic tier or higher",
  "request_id": "req_9f3c1a8e2b6d4f10"
}

{
  "error": "tier_insufficient",
  "message": "Method 'getAssetsByOwner' requires basic tier or higher",
  "request_id": "req_9f3c1a8e2b6d4f10",
  "current_tier": "free",
  "required_tier": "basic",
  "method": "getAssetsByOwner",
  "category": "sol_das",
  "upgrade_url": "https://triport.io/upgrade/basic"
}

{
  "error": "rate_limited",
  "message": "Rate limit exceeded: 20 RPS sustained on sol_read_rpc (free tier)",
  "request_id": "req_2c7b0e44a1f94d83",
  "current_tier": "free",
  "category": "sol_read_rpc",
  "limit_rps": 20,
  "burst_capacity": 40,
  "retry_after_sec": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32002,
    "message": "Method 'getAssetsByOwner' requires basic tier or higher",
    "data": {
      "current_tier": "free",
      "required_tier": "basic",
      "method": "getAssetsByOwner",
      "category": "sol_das",
      "upgrade_url": "https://triport.io/upgrade/basic"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32003,
    "message": "Rate limit exceeded: 20 RPS sustained on sol_read_rpc (free tier)",
    "data": {
      "current_tier": "free",
      "category": "sol_read_rpc",
      "limit_rps": 20,
      "burst_capacity": 40,
      "retry_after_sec": 1
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32601,
    "message": "Method \"bogus_nonexistent_method_42\" on chain \"polygon\" is not recognised",
    "data": {
      "chain": "polygon",
      "method": "bogus_nonexistent_method_42"
    }
  }
}

const res = await fetch("https://api.triport.io/sol", {
  method: "POST",
  headers: {
    "x-token": process.env.TRIPORT_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    jsonrpc: "2.0",
    id: 1,
    method: "getBalance",
    params: ["So11111111111111111111111111111111111111112"],
  }),
});


const body = await res.json();


if (body.error) {
  // JSON-RPC error object
  switch (body.error.code) {
    case -32003: {
      const wait = Number(res.headers.get("Retry-After") ?? body.error.data.retry_after_sec);
      await new Promise((r) => setTimeout(r, wait * 1000));
      // ...then retry
      break;
    }
    case -32002:
      console.error("Upgrade required:", body.error.data.upgrade_url);
      break;
    case -32601:
      console.error("Unknown method:", body.error.data.method);
      break;
    default:
      throw new Error(body.error.message);
  }
}

import { Triport, TierInsufficientError, RateLimitedError } from "@triport/sdk";


const client = new Triport({ token: process.env.TRIPORT_API_KEY! });


try {
  await client.sol.getAssetsByOwner("So11111111111111111111111111111111111111112");
} catch (err) {
  if (err instanceof RateLimitedError) {
    await new Promise((r) => setTimeout(r, err.retryAfterSec * 1000));
    // ...retry
  } else if (err instanceof TierInsufficientError) {
    console.error(`Need ${err.requiredTier}; upgrade at ${err.upgradeUrl}`);
  } else {
    throw err;
  }
}

import time
from triport import Triport
from triport.errors import RateLimitedError, TierInsufficientError


client = Triport(token=os.environ["TRIPORT_API_KEY"])


try:
    client.sol.get_assets_by_owner("So11111111111111111111111111111111111111112")
except RateLimitedError as e:
    time.sleep(e.retry_after_sec)
    # ...retry
except TierInsufficientError as e:
    print(f"Need {e.required_tier}; upgrade at {e.upgrade_url}")