1.4 KiB

Raw Blame History

Quick Start Guide

Get your Natural Language Agreement Oracle running in under 2 minutes!

Prerequisites

Bun installed
Foundry installed
Both alkahest and natural-language-agreements repos cloned in same parent directory
OpenAI API key

One-Command Setup

export OPENAI_API_KEY=sk-your-key-here
./scripts/dev.sh

Done! The oracle is now running and listening for arbitration requests.

To stop:

./scripts/stop.sh

What Just Happened?

The script:

✅ Checked prerequisites
✅ Started Anvil (local blockchain)
✅ Deployed all contracts
✅ Started the oracle

Test It

In another terminal:

bun test tests/nlaOracle.test.ts

Watch the oracle terminal to see it process the arbitration!

Manual Steps (Optional)

If you want more control:

# Terminal 1: Blockchain
anvil

# Terminal 2: Deploy and start oracle
bun run deploy
bun run oracle

# Terminal 3: Test
bun test tests/nlaOracle.test.ts

Deploy to Testnet

# Get Sepolia ETH from faucet first
export DEPLOYER_PRIVATE_KEY=0x...
bun run cli/server/deploy.ts --network sepolia --rpc-url https://sepolia.infura.io/v3/YOUR-KEY

# Start oracle
export ORACLE_PRIVATE_KEY=0x...
export OPENAI_API_KEY=sk-...
bun run cli/server/oracle.ts sepolia

Need Help?

Full docs: README.md
Example test: tests/nlaOracle.test.ts

1.4 KiB Raw Blame History