scemadex-sdk 0.1.2

ScemaDEX — an agentic liquidity layer: intent-based, RL-routed, x402-metered swap execution with bonded (slashable) fills and a peer marketplace where agents trade inference and experience.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

# scemadex-sdk


**An agentic liquidity layer for Solana — not "a DEX."** In ScemaDEX the routing
*intelligence itself* is a metered, learning, accountable product: autonomous
agents solve swap **intents**, **bond** their promises, sell their inferences,
and trade learned experience with one another.

```rust
use scemadex_sdk::{reference_client, demo_intent};

# async fn run() -> scemadex_sdk::Result<()> {

let dex = reference_client();
let (solution, bond) = dex.quote(&demo_intent()).await?;   // solve + escrow bond
assert!(solution.route.splits_valid());
let _ = bond;
# Ok(()) }

```

## The four composing primitives


| | Primitive | Where |
|--|--|--|
| **A** | **Metered inference routing** — quotes produced by a learning policy, sold per-call | `policy`, `EscrowBondEngine::quote_fee` |
| **B** | **Intent solving** — express *what* you want (`Objective::{Price,Speed,Stealth}`), not a path | `intent` |
| **C** | **Signal / reputation oracle** — reputation, pool scores, advice as paid endpoints | `oracle`, `BondLedger` |
| **D** | **Conviction Routing** *(defining)* — the policy escrows a **slashable bond** against its own promise | `bond` |

**Headline:** a `PeerMarket` mesh where agents **sell bonded inferences and
learned experience, and buy better ones from peers** — an economy of machine
intelligence, settled in stablecoins.

## Lean core, injected power


The published crate has **no `solana-sdk` dependency by default**. It defines the
trait surface — `RoutePolicy`, `BondEngine`, `VenueExecutor`, `SignalSource`,
`PeerMarket` — plus working reference implementations (`ReferenceRoutePolicy`,
`EscrowBondEngine`, `LocalPeerMarket`, `SimVenueExecutor`).

### Feature flags


| Feature | Adds | Pulls |
|---------|------|-------|
| *(default)* | Traits, reference impls, `ScemaDex` facade | serde, async-trait, bs58 |
| `scematica` | `integration::DqRoutePolicy` — the real Deep Q\* agent as policy | [`scematica-nn`](https://crates.io/crates/scematica-nn) |
| `ai` | NL → `Intent` parsing + trade narration | `reqwest` |
| `net` | `RemotePeerMarket` — networked mesh client | `reqwest` |

The x402-settled bond engine lives in a separate, unpublished companion crate
because it depends on a proprietary protocol stack. The conviction-weighted
settlement *state machine*, however, ships in the open as `EscrowBondEngine` —
only the on-chain USDC transfer is gated.

## Runnable examples


All run offline — no keypair, RPC, or `solana-sdk`:

```bash
cargo run -p scemadex-sdk --example quote            # A+B: intent -> bonded solution -> execute
cargo run -p scemadex-sdk --example conviction_bond  # D+C: honored vs. slashed bonds + honor-rate ledger
cargo run -p scemadex-sdk --example peer_market      # the mesh: trade bonded inferences & experience
cargo run -p scemadex-sdk --example intent_solving   # B: same trade under Price/Speed/Stealth
```

`reference_client()` wires a *zero* bond (`NoBondEngine`) for the bare
intent/route surface; use **`conviction_client()`** to exercise real
Conviction Routing (conviction-sized, slashable bonds with a ledger) end-to-end.

## License


MIT