Skip to main content
POST
Activate the wallet's Solana smart account (relayer-sponsored, passkey-signed claim)

Authorizations

pid_access
string
cookie
required

JWT access token set by /auth/google/callback or /auth/refresh

Body

application/json
expiry
integer
required

Chain-time expiry (unix seconds) the passkey signed against (TTL ≤ 600s)

feePolicyVersion
integer
required

Signed fee-policy version selecting the fixed protocol percentage

quotedNetworkFeeLamports
string
required

Quoted network fee the client signed against (drift reference, not a cap)

assertion
object
required

Response

Activation result

pid
string
required
Pattern: ^[a-z0-9_]{3,20}@pid$
status
string
required
smartAccountAddress
string
required
balanceLamports
integer
required
requiredLamports
integer
required

Total lamports required (rent + networkFee + protocolFee)

networkFeeLamports
integer
required

Realtime network-cost estimate the backend will attest near

protocolFeeBps
integer
required

Fixed protocol percentage in bps for the quoted policy version

chainTime
integer
required

Chain time (unix seconds) for the activation challenge expiry

treasury
string
required

Canonical revenue vault (informational — enforced on-chain)

feePolicyVersion
integer
required

Fee-policy version the quote was computed under (must be signed)

rpIdHash
string
required

base64url sha256 of the WebAuthn RP ID (bound into the V3 activation payload)