SPOONOS v5 · 56,320 LINES · 798 TESTS · 100% PASS

NATURAL LANGUAGE
CRYPTOGRAPHY

A production-grade natural language cryptography platform with four-layer fee defense,formal verification (Coq proofs), RON compliance (47 states),64+ operations, and 6-language i18n support. Speak naturally—the AI handles everything.

56,320
LINES OF CODE
200+
INTENT PATTERNS
90
PYTHON FILES
798
TESTS (100% PASS)

ARCHITECTURE OVERVIEW

NLP Engine Architecture

A complete conversational AI system—not just a CLI wrapper. The agent processes natural language through multiple sophisticated stages:

  1. Intent Classification — 200+ priority-ordered regex patterns
  2. Anaphora Resolution — Understands "it", "this", "that" from context
  3. Parameter Extraction — Pulls dates, prices, addresses from messy text
  4. Progressive Collection — Asks follow-up questions for missing params
  5. Error Recovery — Transforms cryptic errors into helpful guidance
  6. Memory System — Short-term (50 messages) + long-term preferences

Core Modules (56,320 lines)

agent.py — 5,441 lines — Core agent + intent classification
tools.py — 3,449 lines — 68 CLI command wrappers
crypto_synonyms.py — 418 lines — 200+ natural language mappings
disambiguation.py — 440 lines — 12 disambiguation flows
semantic_memory.py — 379 lines — Natural language queries
explanations.py — 467 lines — 15+ crypto concept explanations
security_advisor.py — 387 lines — Proactive security suggestions
tool_chains.py — 450 lines — Outcome-based workflows
anaphora.py — 416 lines — Pronoun resolution ("it", "this", "that")
// Agent Flow Diagram
┌─────────────────────────────────────────────────────────────────────────────┐
│                              USER INPUT                                      │
│                     "Sign my contract and anchor it"                        │
└─────────────────────────────────────────────────────────────────────────────┘
                                    │
                                    ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                         INTENT CLASSIFIER                                    │
│                                                                              │
│   200+ regex patterns → Matches: ["sign", "anchor"]                         │
│   Confidence: 0.95                                                          │
└─────────────────────────────────────────────────────────────────────────────┘
                                    │
                                    ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                          FILE FINDER                                         │
│                                                                              │
│   Query: "contract" → Found: ~/Documents/contract.pdf                       │
│   Auto-selected (single match)                                              │
└─────────────────────────────────────────────────────────────────────────────┘
                                    │
                                    ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                       COST ESTIMATOR                                         │
│                                                                              │
│   sign: FREE | anchor: 0.10 GAS (~$0.04)                                    │
│   Total: 0.10 GAS                                                           │
└─────────────────────────────────────────────────────────────────────────────┘
                                    │
                                    ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                      CONFIRMATION                                            │
│                                                                              │
│   "I found contract.pdf. This will sign it (FREE) and anchor to Neo N3     │
│    (0.10 GAS ~$0.04). Proceed? [Yes/No]"                                    │
└─────────────────────────────────────────────────────────────────────────────┘
                                    │
                              User: "Yes"
                                    │
                                    ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                        TOOL EXECUTION                                        │
│                                                                              │
│   1. anubis_sign(file_path="contract.pdf") → contract.pdf.sig              │
│   2. anubis_attest(file_path="contract.pdf") → contract.pdf.receipt        │
│   3. anubis_anchor(receipt_path="contract.pdf.receipt") → TX: 0x7a3b...    │
└─────────────────────────────────────────────────────────────────────────────┘
                                    │
                                    ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                          RESPONSE                                            │
│                                                                              │
│   "✓ Done! Your contract is signed and anchored.                           │
│      Signature: contract.pdf.sig                                            │
│      Transaction: 0x7a3b9c2d...                                             │
│      Block: 12847293"                                                       │
└─────────────────────────────────────────────────────────────────────────────┘

NATURAL LANGUAGE CRYPTOGRAPHY

Cryptographic Synonyms

200+ natural language mappings with confidence scores. Users speak naturally, the agent understands cryptography.

"encrypt" → seal (0.95)
"notarize" → sign (0.95)
"immortalize" → anchor (0.85)
"quantum-safe" → seal_pq (0.92)

Disambiguation Flows

12 structured flows for ambiguous inputs. When confidence is close, the agent asks clarifying questions.

"Lock this up"
How would you like to secure this?
1. Seal (encrypt) - 0.001 GAS
2. Vault store - 0.02 GAS
3. Timelock escrow - 0.08 GAS

Semantic Memory

Query past operations in natural language. Time-aware, intent-filtered, keyword searchable.

"What did I anchor last month?"
"Show me all contracts"
"How much GAS have I spent?"

Explanation Mode

15+ cryptographic concept explanations. Ask "why" and get clear, accessible answers.

"Why sign AND anchor?"
Signing proves WHO (authorship).
Anchoring proves WHEN (time).
Together: proof for courts.

Security Advisor

Proactive suggestions based on document content. Detects "will", "confidential", "inheritance" and recommends protections.

"Store my will"
✓ Encrypt with your key
? Set up dead-man switch?
? Add trusted contact?

Tool Chaining

Outcome-based workflows. Express what you want, the agent figures out the steps.

"make tamper-proof" → sign → anchor
"share securely" → seal → vault → share
"if I die" → vault → deadman

Composite Actions

Natural phrases that expand to multiple operations automatically.

"make tamper-proof"
→ sign + anchor (0.05 GAS)
"prove existence"
→ timestamp + anchor (0.06 GAS)
"court-ready"
→ sign + timestamp + anchor (0.06 GAS)
"share secretly"
→ seal + vault_share (0.03 GAS)
"quantum safe"
→ seal_pq (0.002 GAS)
"if I die"
→ vault + escrow_deadman (0.13 GAS)

COMPLETE API REFERENCE

All 64 tools organized by category. Click to expand and view parameters, return types, and examples.

anubis_signFREE

Sign documents with ML-DSA-87 post-quantum signatures

PARAMETERS
NameTypeRequiredDescription
file_pathstringYesPath to the file to sign
output_pathstringNoOutput path for signature
detachedbooleanNoCreate detached signature (default: true)
RETURNS
{ signed_file: "string", signature_file: "string", algorithm: "ML-DSA-87" }
NATURAL LANGUAGE → TOOL CALL
"Sign my contract" → anubis_sign(file_path="contract.pdf")
anubis_verifyFREE

Verify document signatures are valid and authentic

PARAMETERS
NameTypeRequiredDescription
file_pathstringYesPath to the signed file
signature_pathstringNoPath to signature file
RETURNS
{ valid: "boolean", file: "string", algorithm: "string" }
NATURAL LANGUAGE → TOOL CALL
"Is this signature valid?" → anubis_verify(file_path="contract.pdf")
anubis_attestFREE

Create timestamped receipt proving document existence

PARAMETERS
NameTypeRequiredDescription
file_pathstringYesPath to the file to attest
receipt_pathstringNoOutput path for receipt
RETURNS
{ attested_file: "string", receipt_file: "string", hash: "string", timestamp: "ISO8601" }
NATURAL LANGUAGE → TOOL CALL
"Create a timestamp for this document" → anubis_attest(file_path="evidence.pdf")
anubis_keyFREE

Manage ML-DSA-87 and ML-KEM-1024 key pairs

PARAMETERS
NameTypeRequiredDescription
actionstringYesAction: init, show, export, rotate
low_memorybooleanNoUse low-memory mode for constrained devices
RETURNS
{ fingerprint: "string", algorithms: ["ML-DSA-87","ML-KEM-1024"] }
NATURAL LANGUAGE → TOOL CALL
"Initialize my keys" → anubis_key(action="init")

NATURAL LANGUAGE PATTERNS

The agent understands 200+ natural language patterns. Here are examples organized by category. You can say these phrases (or variations) and Anubis will understand.

Signing & Verification

"Sign my contract"sign
"Sign this document"sign
"Is this signature valid?"verify
"Verify the signature"verify
"Create a timestamp"attest
"Prove this existed"attest

Blockchain Anchoring

"Put this on the blockchain"anchor
"Anchor to Neo"anchor
"Make this permanent"anchor
"Queue for batch anchoring"batch_add
"Flush the batch"batch_flush

Property & Deeds

"Register this deed"deed_anchor
"Transfer property to Alice"deed_transfer
"Show deed history"deed_history
"Draft a warranty deed"deed_init

Wills & Estates

"Register my will"will_anchor
"Add beneficiary"will_beneficiary
"Revoke my will"will_revoke

Marriage & Divorce

"Get married to Alice"marriage_create
"Register our marriage"marriage_create
"Mint wedding rings"rings_mint
"File for divorce"divorce

Escrow & Conditional Release

"Release on January 1st"escrow_timelock
"Hold until 2026"escrow_timelock
"Release when paid"escrow_payment
"Require 2-of-3 signatures"escrow_multisig
"If I die, release to my kids"escrow_deadman
"If I don't check in for 30 days"escrow_deadman
"Check in"heartbeat
"Reset dead-man timer"heartbeat

Vault & Storage

"Upload to my vault"vault_upload
"Seal and encrypt this"seal
"Download from vault"vault_download
"Share with Alice"vault_share
"How much storage?"vault_stats

Marketplace

"Sell this for 10 GAS"market_list
"List on marketplace"market_list
"Buy listing #42"market_buy
"What's for sale?"market_browse
"Claim my revenue"revenue_claim

Membership

"Upgrade to Notary"member_mint
"Subscribe to Vault tier"member_mint
"Renew membership"member_renew
"What's my tier?"member_status
"Show pricing"member_tiers

COMPLETE FEE SCHEDULE

All fees are paid in GAS on Neo N3. USD estimates assume 1 GAS ≈ $0.40.

FREE OPERATIONS

Sign document
ML-DSA-87 post-quantum signature
FREE
Verify signature
Validate signature authenticity
FREE
Create attestation
Timestamped receipt
FREE
Key management
Init, show, export keys
FREE
Browse marketplace
View listings
FREE
Check membership
View tier status
FREE
Vault list/download
Access your files
FREE

PAID OPERATIONS

Anchor to blockchain
~$0.04
0.10 GAS
Batch anchor (8 items)
~$0.20 total
0.50 GAS
Register deed
~$0.15
0.38 GAS
Transfer deed
~$0.06
0.15 GAS
Register will
~$0.15
0.38 GAS
Anchor contract
~$0.12
0.30 GAS
Register marriage
~$0.18
0.45 GAS
Mint wedding rings
~$0.30
0.75 GAS
File divorce
~$0.08
0.20 GAS
Escrow (timelock)
~$0.04
0.10 GAS
Escrow (payment)
~$0.06 + commission
0.15 GAS + 2%
Escrow (multisig)
~$0.08
0.20 GAS
Escrow (dead-man)
~$0.10
0.25 GAS
Heartbeat check-in
~$0.004
0.01 GAS
Seal to NeoFS
~$0.04
0.10 GAS
Vault upload
~$0.0004/MB
0.001 GAS/MB
Vault share
~$0.002
0.005 GAS
List on marketplace
~$0.04
0.10 GAS
Identity registration
~$0.12
0.30 GAS

MEMBERSHIP TIERS

Free0 GAS
Storage: 10 MB
Commission: 15%
Sign, Verify, Attest, Basic Anchoring
Notary50 GAS/year
Storage: 100 MB
Commission: 5%
+ Marketplace listing, 10% discount, Priority support
Vault200 GAS/year
Storage: 1 GB
Commission: 2%
+ Escrow, Private batch, 15% discount, Dedicated support

MULTI-PLATFORM ACCESS

Access Anubis Notary through multiple interfaces—all powered by the same SpoonOS agent.

Terminal Chat

Interactive CLI with natural language

anubis-chat

Telegram Bot

Chat with @AnubisNotaryBot

@AnubisNotaryBot

Discord Bot

Add to your server

/anubis sign

REST API

Programmatic access

POST /api/v1/chat

INSTALLATION

Get started with the SpoonOS agent in minutes.

1. Install the Agent

# Install via pip
pip install anubis-spoon
# Or clone from source
git clone https://github.com/anubis-notary/anubis-spoon
cd anubis-spoon && pip install -e .

2. Configure

# config.json
{
"neo_rpc": "https://mainnet1.neo.coz.io:443",
"owner_address": "NXV7ZhHiyM1aHXwpVsRZC6BwNFP2jghXAq",
"simulation_mode": false
}

3. Start Chatting

# Start interactive chat
anubis-chat
# Or start the API server
anubis-server --port 8080
# Or run Telegram bot
anubis-telegram --token YOUR_BOT_TOKEN

4. Python Integration

from
anubis_agent
import
AnubisAgent
agent = AnubisAgent()
result = agent.run(
"Sign my contract and anchor it"
)
print
(result)

READY TO TALK TO ANUBIS?

Install the SpoonOS agent and start using natural language cryptography today.