chain.guard.v1.GuardSignerService
SignProtectedAction
Method
POST
Path
chain.guard.v1.GuardSignerService/SignProtectedAction
Service
chain.guard.v1.GuardSignerService
Visibility
Authentication
Session token
MFA Requirement
POST
chain.guard.v1.GuardSignerService/SignProtectedAction Request
Testnet
curl --request POST \ \
--url 'https://api.testnet.polyester.com/chain.guard.v1.GuardSignerService/SignProtectedAction' \
--header 'Content-Type: application/json' \
--header 'Connect-Protocol-Version: 1' \
--data '{
"action": "PROTECTED_ACTION_FUNDING_SET_EXTERNAL_WHITELIST_REQUIRED",
"args": {
"externalWhitelist": {
"addresses": [
"0x3333333333333333333333333333333333333333"
],
"polychainChainId": 1
}
},
"subaccountId": "6789012345678"
}'Responses
{
"approval": {
"deadlineUnix": "1",
"nonceSpace": "1",
"signature": "0xabcdefg..............................."
}
}Request
chain.guard.v1.SignProtectedActionRequestResponse
chain.guard.v1.SignProtectedActionResponse subaccountId string (fixed64)
Optional subaccount public id. When omitted, the authenticated caller's root account is used as the target account.
action enum
Protected action to approve.
3 fields
2 fields
polychainChainId integer (int32)
External network identifier for the whitelist update.
addresses string[]
Hex-encoded destination payloads to add or remove. Each value must be 0x-prefixed bytes.
1 field
addresses string[]
EVM account addresses to add or remove from the internal transfer whitelist.
one-of
1 field
required boolean
Required must be false for GuardSigner approvals. Enabling a requirement uses an empty approval on-chain and should not be signed here.
3 fields
nonceSpace string (uint64)
Nonce space used for the signed approval. Normal flows use 0.
deadlineUnix string (uint64)
Deadline as a unix timestamp in seconds, derived from chain time.
signature string (byte)
EIP-712 signature over the guard approval message. Must not be empty.
| Key | HTTP status | Connect code | Error | When |
|---|---|---|---|---|
| unauthenticated | 401 | unauthenticated | Unauthenticated | Authentication required. |
| permission-denied | 403 | permission_denied | Permission Denied | Permission denied. |
| invalid-argument | 400 | invalid_argument | Invalid Argument | Invalid argument. |
| not-found | 404 | not_found | Not Found | Not found. |
| unavailable | 503 | unavailable | Unavailable | Service unavailable. |