Skip to main content

​
Connect Agent & Wallet

This guide walks through connecting your first agent and wallet on Tempo Testnet. By the end, you’ll have an agent ready to make policy-enforced payments with free testnet tokens.

​
Step 1: Create a Wallet

Create a Tempo Testnet wallet to hold pathUSD tokens.
1

Navigate to Wallets

Go to Wallets in the sidebar and click Create Wallet.
2

Configure the wallet

FieldValue
NameTest Operations Wallet
Custody TypePRIVY (recommended)
Chain TypeEVM
3

Provision onchain

Click Provision to assign an onchain address on Tempo Testnet. Your wallet is now ready to receive pathUSD.
4

Fund the wallet

Use the Faucet button on the wallet detail page to receive free testnet pathUSD tokens.

​
Step 2: Connect an Agent

1

Navigate to Agents

Go to Agents in the sidebar and click Connect Agent.
2

Fill in details

FieldDescriptionExample
NameHuman-readable nameTest Payment Agent
TypeAgent frameworkCUSTOM (or your framework)
DescriptionWhat the agent doesQuickstart test agent
3

Connect the agent

Click Connect Agent. The agent starts in ACTIVE status.

​
Via API

curl -X POST https://conto.finance/api/agents \
  -H "Authorization: Bearer $CONTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Test Payment Agent",
    "agentType": "CUSTOM",
    "description": "Quickstart test agent"
  }'
Connect the wallet to your agent with spending limits.
1

Open agent detail page

Click on your agent to open its detail page.
2

Assign wallet

In the Wallets section, click Assign Wallet and select the Tempo Testnet wallet.
3

Configure spending limits

Set limits for this agent-wallet link:
SettingRecommended ValuePurpose
Per Transaction50Max per payment
Daily Limit500Max per day
Weekly Limit2000Max per week
Monthly Limit5000Max per month
Do not set Per Transaction to 0 — this blocks all payments at the wallet level before policies are evaluated.
4

Set time windows (optional)

Restrict when the agent can transact:
{
  "allowedHoursStart": 9,
  "allowedHoursEnd": 17,
  "allowedDays": ["Mon", "Tue", "Wed", "Thu", "Fri"]
}
Defaults are unrestricted: hours 0-24, all 7 days. For testing, leave time windows at their defaults (24/7).

​
Step 4: Generate an SDK Key

1

Open SDK Keys tab

On the agent detail page, click the SDK Keys tab.
2

Generate a key

Click Generate New Key and enter a name (e.g., “Testnet Key”).
3

Save the key

Copy and save the key immediately — it’s only shown once.
Store it as an environment variable:
export CONTO_API_KEY="conto_agent_your_key_here"
For scopes, expiration, and best practices, see the Authentication guide.

​
Step 5: Verify Your Setup

Confirm everything is connected: 
curl https://conto.finance/api/sdk/setup \
  -H "Authorization: Bearer $CONTO_API_KEY"
Check that:
  • agent.status is "ACTIVE"
  • wallets array contains your Tempo Testnet wallet with a balance
  • scopes includes payments:request and payments:execute

​
Agent Types

TypeDescription
OPENAI_ASSISTANTOpenAI Assistants API
ANTHROPIC_CLAUDEClaude via API
LANGCHAINLangChain agents
AUTOGPTAutoGPT instances
CUSTOMAny other agent framework

​
Agent Status

ACTIVE

Agent can make transactions. Default status.

PAUSED

Temporarily disabled. Use for maintenance.

SUSPENDED

Suspended by admin. Requires manual review.

REVOKED

Permanently disabled. Cannot be reactivated.

​
Next Steps

Connect Your Agent

Framework-specific integration code

Test Payments & Policies

Apply policies and run test transactions