Quickstart

```bash
npx create-aroha-agent my-agent
cd my-agent && npm install && npm run dev
```

That's it. Your agent is running at `http://localhost:3001/aroha/v1`.

Open `src/handlers.ts` and replace the stub implementations with your logic.

Wrap your MCP tools:

```typescript
import { wrapMcp, registryPublicKeyResolver } from "@aroha-sdk/mcp-bridge";

const agent = await wrapMcp(tools, {
  name: "my-tools",
  resolvePublicKey: registryPublicKeyResolver(),       // who may call (required)
  handlers: { "my-tool": async (args) => myTool(args) }, // one per tool name (required)
});
await agent.start();
// Your MCP tools are now an Aroha agent at http://localhost:3001
```

Full guide: [MCP Quickstart →](quickstart-mcp.md)

Call any Aroha agent as a LangChain tool:

```typescript
import { createArohaLangChainTool } from "@aroha-sdk/langchain-bridge";

const tool = await createArohaLangChainTool(
  "http://localhost:3001",
  "search-flights",
  "Search available flights by origin, destination, and date"
);
// Use `tool` with createOpenAIFunctionsAgent, AgentExecutor, etc.
```

Full guide: [LangChain Quickstart →](quickstart-langchain.md)

npx create-aroha-agent my-booking-agent

my-booking-agent/
├── src/
│   ├── server.ts      # ArohaServer setup
│   ├── handlers.ts    # ← your business logic goes here
│   ├── identity.ts    # loads (or generates) the agent's Ed25519 key
│   ├── mandate.ts     # mandate chain verification
│   └── manifest.ts    # capability definitions
├── .env               # AROHA_AGENT_DID=did:aroha:my-booking-agent, AROHA_PRIVATE_KEY (filled on first run)
├── README.md
├── package.json
└── tsconfig.json

cd my-booking-agent
npm install
npm run dev

[my-booking-agent] Aroha endpoint : http://localhost:3001/aroha/v1
[my-booking-agent] DID document  : http://localhost:3001/.well-known/aroha-agent.json
[my-booking-agent] DID           : did:aroha:my-booking-agent

case "search-items": {
  // TODO: replace with your business logic
  const result = { items: [], message: "No results yet — implement search-items" };
  return buildEnvelope("ArohaResponse", agentDID, from,
    { capability, result },
    correlationId, privateKey);
}

# Check your agent's DID document
curl http://localhost:3001/.well-known/aroha-agent.json

# Check the environment and that the endpoint answers
npx @aroha-sdk/cli doctor http://localhost:3001

git clone https://github.com/ArohaLabs/aroha-protocol
cd aroha-protocol && npm install && npm run build
npm run demo:vc