Skip to main content

Address Books

Address books allow you to maintain a list of whitelisted destination addresses with optional approval workflows. This adds a layer of security by ensuring transactions can only be sent to pre-approved addresses.

Create Address Book Items​

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "items": [
         {
           "address": "0x742d35Cc6634C0532925a3b8...",
           "network": "ethereum-mainnet",
           "name": "Supplier Wallet",
           "tags": ["supplier", "verified"]
         }
       ]
     }' \
     https://api.carabaas.com/api/v1/addressbooks

List Address Book Items​

curl -H "Authorization: Bearer $TOKEN" \
     https://api.carabaas.com/api/v1/addressbooks

Approve Address Book Items​

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "itemIds": ["item-id-1", "item-id-2"]
     }' \
     https://api.carabaas.com/api/v1/addressbooks/approve

Bulk Approve​

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "itemIds": ["item-id-1", "item-id-2", "item-id-3"]
     }' \
     https://api.carabaas.com/api/v1/addressbooks/bulk-approve

Delete Address Book Item​

curl -X DELETE -H "Authorization: Bearer $TOKEN" \
     https://api.carabaas.com/api/v1/addressbooks/{itemId}

Revoke Approval​

curl -X DELETE -H "Authorization: Bearer $TOKEN" \
     https://api.carabaas.com/api/v1/addressbooks/approvals/{approvalId}

See Also​