Skip to content
PortunaPortunaPortunaDocsTestnet

Changelog

Changes that matter to your integration, newest first. New fields and event types may appear over time: accept the ones you do not know.

  • New name: the company is Portuna, the product is Portuna Sweep. Webhooks come with the Portuna-Signature, Portuna-Event and Portuna-Delivery headers and User-Agent: portuna-webhooks/1. New API keys start with ptn_test_ and ptn_live_; keys issued before keep working. The TypeScript package is @portuna/sdk, the Go package portuna.
  • Reason codes: a sweep’s and a revocation’s reason and a hot wallet’s error are stable codes, such as insufficient_gas_balance or chain_unavailable, and never the node’s own messages; a chain’s balance error is chain_unavailable. Every code: Statuses, confirmations and reorgs.
  • Times in UTC: every time in the API and in webhooks is RFC 3339 in UTC, with Z.
  • SDKs: the lists, usage, the delivery log and test events, with iteration over every page, and the webhook.test event.
  • Lists and reports: GET /v1/sweeps, GET /v1/revocations, GET /v1/ledger, GET /v1/usage and GET /v1/webhook/deliveries, and the webhook.test event from POST /v1/webhook/test.
  • API keys: an organization can have several keys; a revoked key gets 401 at once, a disabled account 403 partner_disabled.
  • Testnets: the API is available on Sepolia and BSC testnet, with the Go and TypeScript SDKs.