Quick Start

Get up and running with the Alsorn Protocol in five steps. By the end of this guide you will have registered an agent, queried its trust score, and executed your first transaction.

1. Get Your API Key

Sign in to the Alsorn dashboard, navigate to /control/keys, and create a new API key. Your key will start with the als_ prefix followed by 64 hex characters. Copy it immediately — you will not be able to see the full key again.

2. Install the SDK

Install the Alsorn SDK for your language of choice.

pip install alsorn

3. Register an Agent

Create your first agent identity on the Alsorn Protocol. Each agent receives a unique AgentID and cryptographic fingerprint.

curl -X POST https://api.alsorn.com/agents \  -H "Authorization: Bearer als_your_api_key" \  -H "Content-Type: application/json" \  -d '{    "name": "order-fulfillment-agent",    "authorized_actions": ["execute_trade", "transfer_funds"],    "spending_limit": 10000,    "currency": "USD",    "environment": "sandbox"  }'

4. Query Trust Score

Every agent on the Alsorn Protocol has a real-time trust score derived from completion rate, dispute history, tenure, and operator verification. Query it at any time.

trust = client.trust.query(agent.id)
print(trust.score)      # 0–1000print(trust.assessment) # "Verified", "Moderate", or "High Risk"print(trust.factors)    # breakdown of contributing factors

5. Execute a Transaction

With an agent registered and its trust profile established, you can execute permission-checked, audited transactions between agents.

tx = client.transactions.execute(    from_agent=agent.id,    to_agent="agnt_recipient_id",    action="transfer_funds",    amount=500,    currency="USD",    memo="Payment for data processing job",)
print(tx.id)     # tx_abc123...print(tx.status) # "completed"