@heyanon-arp/cli 0.0.6 → 0.0.8

package/README.md

@@ -2,7 +2,7 @@
 
 Command-line client for the **Agent Relationship Protocol** (ARP).
 Register an agent identity, exchange signed envelopes with other
-agents, open contracts with on-chain Solana escrow, and finalize
+agents, open delegations with on-chain Solana escrow, and finalize
 payment-on-delivery cycles.
 
 If you've ever needed two autonomous agents (LLM workers, marketplaces,
@@ -39,7 +39,6 @@ heyarp --help
 
 # 2. Register an agent — generates a fresh did:arp:… identity locally.
 heyarp register --name "MyAgent" --description "translation worker" \
-    --endpoint-url https://my-agent.example.com \
     --tag translation --tag en-ru \
     --password 'choose-a-strong-password'
 
@@ -51,8 +50,8 @@ heyarp send-handshake did:arp:<other-agent-did>
 That's the entry point. From there the typical workflow is:
 
 ```
-handshake → contract propose/sign → delegation offer/accept →
-work request/respond → receipt propose/cosign → cycle.released
+handshake → delegation offer/accept → work request/respond →
+receipt propose/cosign → cycle.released
 ```
 
 …each step a signed envelope on the wire, every signature verifiable
@@ -90,7 +89,7 @@ heyarp agents [--tag X]            # discover agents (public catalog)
 heyarp did-doc <did>               # resolve a DID document
 heyarp publish | pause | unpause   # control publication state
 heyarp rotate <did>                # rotate identity key (DID stays fixed)
-heyarp update <did>                # patch name / description / endpoint
+heyarp update <did>                # patch name / description / tags
 ```
 
 ### Talking to peers
@@ -102,17 +101,20 @@ heyarp status <rel-id>                  # relationship + cycle state
 heyarp events <rel-id>                  # full event history
 ```
 
-### Contracts & delegations
+### Delegations
 ```
-heyarp contract propose <did> --pricing flat|usage_based --rate-amount … \
-    --rate-currency 'SOL:solana-devnet' --rate-unit task \
-    --settlement escrow --scope "<scope summary>"
-heyarp contract sign <rel-id> <ctr-id>
-heyarp contracts <rel-id> --json
-heyarp delegation offer <recipient-did> <ctr-id> \
-    --title "…" --amount 0.2 --currency 'SOL:solana-devnet' \
+# The buyer offers a delegation with the agreed terms INLINE (scope /
+# pricing / amount) — there is no separate contract step.
+# Settlement is always escrow; the condition_hash binds these same terms
+# to the escrow lock.
+heyarp delegation offer <recipient-did> \
+    --delegation-id <uuid> --title "…" \
+    --scope "<scope summary>" \
+    --pricing-model flat \
+    --amount 0.2 --currency 'SOL:solana-devnet' \
+    --deadline 2026-12-31T23:59:59Z \
     --escrow-lock-from-file ./lock.json
-heyarp delegation accept <rel-id> <del-id>
+heyarp delegation accept <rel-id> <del-id>   # counterparty accepts
 heyarp delegations <rel-id>
 ```
 
@@ -136,7 +138,7 @@ heyarp receipts <rel-id> --json
 heyarp wallet create-lock --delegation-id <uuid> \
     --recipient-pubkey <base58> --amount-lamports 200000000 \
     --condition-hash <hex> --expiry-secs $(($(date +%s) + 86400*3)) \
-    --contract-id <ctr-uuid>           # writes lock.json
+    > lock.json
 heyarp wallet sign-settlement-release \
     --delegation-id <uuid> --payer-settlement-pubkey <…> --payee-settlement-pubkey <…> \
     --mint-pubkey 11111111111111111111111111111111 --lock-amount … \
@@ -146,13 +148,6 @@ heyarp wallet verify-release --delegation-id <uuid> --json
 heyarp wallet derive-pdas --delegation-id <uuid> --json
 ```
 
-### Memory (cross-agent state)
-```
-heyarp memory add <peer-did> --kind note --scope thread_only \
-    --content "…" --commit-after immediate|settlement_finalized
-heyarp memory list <rel-id> --json
-```
-
 Every command supports `--help` for full flag detail. Add `--trace` at
 the root for stack traces on errors; add `--verbose` on a list/send
 command for per-row JSON or envelope previews.
@@ -204,7 +199,7 @@ RPC URL and the server's deploy cluster MUST agree, otherwise
 `wallet verify-release` reads PDAs from a chain that never saw your
 `create_lock` tx.
 
-When a contract's `settlement = escrow` is signed:
+When a delegation's `settlement = escrow` is offered:
 1. The buyer builds an on-chain lock for the agreed amount using
    `heyarp wallet create-lock` (the CLI auto-discovers the program id
    from the server).