Create NLA Escrow

Help the user create a blockchain escrow backed by a natural language demand using the nla CLI.

Overview

An NLA escrow locks ERC20 tokens on-chain. Anyone can attempt to fulfill the escrow's natural language demand. An AI oracle evaluates fulfillments and releases the tokens if the demand is satisfied.

Step-by-step instructions

1. Gather requirements

Collect the following from the user conversationally:

Required: - Demand: The natural language condition that must be fulfilled. Help the user craft something clear and unambiguous. - Amount: Number of tokens to escrow (in the token's smallest unit - no automatic decimal conversion). - Token address: ERC20 token contract address (0x...). - Oracle address: Address of the oracle that will arbitrate.

Optional: - Arbitration provider: OpenAI (default), Anthropic, or OpenRouter. - Arbitration model: e.g. gpt-4o-mini (default), claude-3-5-sonnet-20241022, openai/gpt-4o. - Arbitration prompt: Custom prompt template with {{demand}} and {{obligation}} placeholders.

2. Check prerequisites

# Verify CLI is available
which nla

# Check current network
nla network

# Check wallet is configured
nla wallet:show

If no wallet is configured, the user must either: - Run nla wallet:set --private-key <key> - Pass --private-key <key> to the command - Set the PRIVATE_KEY environment variable

3. Help craft the demand

Guide the user to write an effective demand: - Be specific and evaluable by an LLM - Consider: what counts as valid fulfillment? Is the condition verifiable? - For claims requiring real-world knowledge, suggest models with search (Perplexity search is available if the oracle has it configured) - The demand, provider, model, and prompt are all encoded on-chain and publicly visible - never include secrets

4. Execute escrow creation

nla escrow:create 
  --demand "<demand text>" 
  --amount <amount> 
  --token <token_address> 
  --oracle <oracle_address> 
  [--arbitration-provider "<provider>"] 
  [--arbitration-model "<model>"] 
  [--arbitration-prompt "<prompt>"]

5. Record output

The command outputs an escrow UID (0x...). This UID is needed for fulfillment and collection. Present it clearly to the user and explain next steps.

Key details

• Available networks: anvil (local), sepolia, base-sepolia, mainnet. Switch with nla switch <network>.
• For local dev, nla dev starts Anvil, deploys contracts, creates mock tokens, and starts the oracle.
• Public demo oracle on Sepolia: 0xc5c132B69f57dAAAb75d9ebA86cab504b272Ccbc.
• Default arbitration prompt: ``` Evaluate the fulfillment against the demand and decide whether the demand was validly fulfilled

Demand: {{demand}}

Fulfillment: {{obligation}} ```

Example

nla escrow:create 
  --demand "Provide a valid proof that P != NP" 
  --amount 1000000 
  --token 0xa513e6e4b8f2a923d98304ec87f64353c4d5c853 
  --oracle 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266 
  --arbitration-provider "Anthropic" 
  --arbitration-model "claude-3-5-sonnet-20241022"