Activate the wallet's Solana smart account (relayer-sponsored, passkey-signed claim)

curl --request POST \
  --url https://api.pid.peridotvault.com/v1/account/activate \
  --header 'Content-Type: application/json' \
  --cookie pid_access= \
  --data '
{
  "expiry": 123,
  "feePolicyVersion": 123,
  "quotedNetworkFeeLamports": "<string>",
  "assertion": {
    "id": "<string>",
    "signature": "<string>",
    "authenticatorData": "<string>",
    "clientDataJSON": "<string>"
  }
}
'

const options = {
  method: 'POST',
  headers: {cookie: 'pid_access=', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    expiry: 123,
    feePolicyVersion: 123,
    quotedNetworkFeeLamports: '<string>',
    assertion: {
      id: '<string>',
      signature: '<string>',
      authenticatorData: '<string>',
      clientDataJSON: '<string>'
    }
  })
};

fetch('https://api.pid.peridotvault.com/v1/account/activate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.pid.peridotvault.com/v1/account/activate"

payload = {
    "expiry": 123,
    "feePolicyVersion": 123,
    "quotedNetworkFeeLamports": "<string>",
    "assertion": {
        "id": "<string>",
        "signature": "<string>",
        "authenticatorData": "<string>",
        "clientDataJSON": "<string>"
    }
}
headers = {
    "cookie": "pid_access=",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.pid.peridotvault.com/v1/account/activate"

	payload := strings.NewReader("{\n  \"expiry\": 123,\n  \"feePolicyVersion\": 123,\n  \"quotedNetworkFeeLamports\": \"<string>\",\n  \"assertion\": {\n    \"id\": \"<string>\",\n    \"signature\": \"<string>\",\n    \"authenticatorData\": \"<string>\",\n    \"clientDataJSON\": \"<string>\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("cookie", "pid_access=")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "pid": "<string>",
  "status": "<string>",
  "smartAccountAddress": "<string>",
  "balanceLamports": 123,
  "requiredLamports": 123,
  "networkFeeLamports": 123,
  "protocolFeeBps": 123,
  "chainTime": 123,
  "treasury": "<string>",
  "feePolicyVersion": 123,
  "rpIdHash": "<string>"
}

{
  "statusCode": 400,
  "message": [
    "handle must be 3-20 chars: lowercase letters, numbers, underscore"
  ]
}

{
  "statusCode": 401,
  "message": "Unauthorized"
}

{
  "statusCode": 404,
  "message": "No Identity found"
}

{
  "statusCode": 429,
  "message": "ThrottlerException: Too Many Requests"
}

POST

account

activate

Activate the wallet's Solana smart account (relayer-sponsored, passkey-signed claim)

curl --request POST \
  --url https://api.pid.peridotvault.com/v1/account/activate \
  --header 'Content-Type: application/json' \
  --cookie pid_access= \
  --data '
{
  "expiry": 123,
  "feePolicyVersion": 123,
  "quotedNetworkFeeLamports": "<string>",
  "assertion": {
    "id": "<string>",
    "signature": "<string>",
    "authenticatorData": "<string>",
    "clientDataJSON": "<string>"
  }
}
'

const options = {
  method: 'POST',
  headers: {cookie: 'pid_access=', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    expiry: 123,
    feePolicyVersion: 123,
    quotedNetworkFeeLamports: '<string>',
    assertion: {
      id: '<string>',
      signature: '<string>',
      authenticatorData: '<string>',
      clientDataJSON: '<string>'
    }
  })
};

fetch('https://api.pid.peridotvault.com/v1/account/activate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.pid.peridotvault.com/v1/account/activate"

payload = {
    "expiry": 123,
    "feePolicyVersion": 123,
    "quotedNetworkFeeLamports": "<string>",
    "assertion": {
        "id": "<string>",
        "signature": "<string>",
        "authenticatorData": "<string>",
        "clientDataJSON": "<string>"
    }
}
headers = {
    "cookie": "pid_access=",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.pid.peridotvault.com/v1/account/activate"

	payload := strings.NewReader("{\n  \"expiry\": 123,\n  \"feePolicyVersion\": 123,\n  \"quotedNetworkFeeLamports\": \"<string>\",\n  \"assertion\": {\n    \"id\": \"<string>\",\n    \"signature\": \"<string>\",\n    \"authenticatorData\": \"<string>\",\n    \"clientDataJSON\": \"<string>\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("cookie", "pid_access=")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "pid": "<string>",
  "status": "<string>",
  "smartAccountAddress": "<string>",
  "balanceLamports": 123,
  "requiredLamports": 123,
  "networkFeeLamports": 123,
  "protocolFeeBps": 123,
  "chainTime": 123,
  "treasury": "<string>",
  "feePolicyVersion": 123,
  "rpIdHash": "<string>"
}

{
  "statusCode": 400,
  "message": [
    "handle must be 3-20 chars: lowercase letters, numbers, underscore"
  ]
}

{
  "statusCode": 401,
  "message": "Unauthorized"
}

{
  "statusCode": 404,
  "message": "No Identity found"
}

{
  "statusCode": 429,
  "message": "ThrottlerException: Too Many Requests"
}

Authorizations

pid_access

string

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

Show child attributes

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)

Overview

Endpoints

Activate the wallet's Solana smart account (relayer-sponsored, passkey-signed claim)

Authorizations

Body

Response