URnetwork
•••
Operator API

URnetwork API: Wallet

Version 1.0.0 · 201 operations across 14 groups.OpenAPI spec ↗

URnetwork implements the UR protocol operator spec in full. UR protocol ↗

Wallet

4 operations

GET/wallet/balance

Bearer authwalletBalance

Get the balance for the USDC user custody wallet. The user custody wallet allows URnetwork to query the balance, but the user must take actions against the wallet.

Responses2 statuses · show schema
200
wallet_info
object
wallet_id
string
token_id
string
blockchain
string
blockchain_symbol
string
create_date
string
balance_usdc_nano_cents
integer
address
string
403
No body

POST/wallet/validate-address

Bearer authwalletValidateAddress

Validate a USDC wallet address on the user custody wallet chain. This can be used to check whether an address can receive a transfer out from the user custody wallet. Please use this before initiating any transfer out to avoid lost funds.

Request bodyshow schema
address
string
chain
string

Optional. The blockchain the address is on. For a Circle chain this is the Circle blockchain param (see https://developers.circle.com/w3s/reference/createvalidateaddress) and validation is Circle's; TAO is validated locally as a Bittensor ss58 address and is recorded for future use only, never as a payout destination.

Responses1 status · show schema
200
valid
boolean

POST/wallet/circle-init

Bearer authwalletCircleInit

Initialize the Circle USDC user self custody wallet. This starts a process that must be completed by the user.

Responses2 statuses · show schema
200
user_token
object
user_token
string
encryption_key
string
challenge_id
string
error
object
message
string
403
No body

POST/wallet/circle-transfer-out

Bearer authwalletCircleTransferOut

Set up a transfer from the Circle USDC user self custody wallet to an address. This starts a process that must be completed by the user.

Request bodyshow schema
request_id
string (uuid)

Caller-generated operation identity. Persist with the exact transfer intent before the first call and reuse unchanged for every retry, including after application restart. A distinct intended transfer requires a new id. Missing ids are refused; the server never invents a replacement.

to_address
string
amount_usdc_nano_cents
integer

Positive exact USDC amount, with one dollar represented by 1000000000. Values not representable with six decimals are refused.

terms
boolean

user consent to accept terms of transfer

Responses2 statuses · show schema
200
request_id
string (uuid)
challenge_status
string

Status of the original retained user-confirmation challenge. COMPLETE is not a payment settlement or transfer receipt. Known challenges are observed without another transfer submission.

enum: PENDING, IN_PROGRESS, COMPLETE, FAILED, EXPIRED
user_token
object
user_token
string
encryption_key
string
challenge_id
string
error
object
message
string
403
No body