Conexple

Open-source consumer affiliate protocol on Solana — redirect existing merchant marketing commissions to everyday consumers, not influencers.

Status: v0.1 alpha — hackathon prototype. Deployed to Solana devnet only. Smart contracts are unaudited. Do not use with real funds.

• Live demo: alpha.conexple.com (Cloudflare Workers — static assets)
• Operator backend: conexple-worker-operator.sornwin.workers.dev (Cloudflare Workers — /health, /settle/run, /webhook/purchase, etc.)
• Solscan-verifiable example tx: 3voysBj...A5Q6t (record_purchase by wallet E, amount=1000)
• 6 merchants on chain — 3 deployer-signed (id 1–3) plus 3 BYOK merchants (id 4, 5, 6) initialized by independent keypairs that signed their own initialize_merchant instruction. See submission/byok-merchant-04-receipt.json + submission/settle-receipt.json for traceable proof.
• Multi-cycle settlement proof — recent on-chain add_earnings transactions distributing commission across upline:
  • aMnXq4v4…n2S — customer K → 4 upline × 571 base units (merchant 04 BYOK proof)
  • 3cVWq6SA…aZZf — customer of merchant 05 → 5 upline × 285 base units
  • PfPdB7mn…vJ3 — customer of merchant 06 → 3 upline × 428 base units
  • 2c1ND1Bx…DS56 — second customer of merchant 05 → 5 upline × 214 base units
• On-chain escrow security upgrade (2026-05-11) — closed 4 Anchor authorization gaps in conexple_escrow (recipient-token binding, network-oracle auth, cross-merchant pending binding). Upgrade tx: 3m6H4ryM…XcUd. See SECURITY.md §"Pre-submission audit".
• Program IDs (Solana devnet):
  • conexple_protocol — D1HVppRLhT6wmUxmaM4QABytmcBDEmKuuuMoa7HkKSbn
  • conexple_network — 9nrHZqJcT3zLcK6eTu7ZLBBAU3Rr2eecnFYF413YePt9
  • conexple_escrow — 9eTvjKrfbYy6JhFMJnuFo5ATCN6uS115J196bvPbmMXU
  • conexple_oracle — 9CQFV9oPYKWE4Yg4w8mwJxsdibPeZJrKoTqcp2iTi1qz
• Demo USDC mint (devnet, mock): DMVSU4BNqqLSmQeo5wop3SnUsA3xkoEvJAqNHe2e1rNG
• Pitch video (≤ 3 min): youtu.be/ToolLDP2AIw
• Technical demo (2–3 min): youtu.be/XSwwHwVHtBw
• Pitch deck (PDF): submission/pitch-deck.pdf (build from pitch-deck-outline.md)
• License: Apache 2.0 · permissive, patent grant, fork-friendly

Why consumers should be paid

Affiliate budgets exist. Today they flow to influencers and broadcasters who are paid for reach, not for purchases. Conexple redistributes that same budget to the people who actually buy: 5 levels of upline consumers and a public social pool, all enforced on chain.

Long-term, the goal is bigger than affiliate fairness. We're building toward a basic-income economy from consumption — where the act of buying itself produces income for a network of real customers, not a handful of permanent influencers.

Positions expire by design — on inactivity or once a wallet has earned back its own spend × multiplier. The high-yield seats don't stay with the same wallets forever, and re-entry is open to anyone who buys again. No permanent residents. The cycle is the economy.

What is Conexple

Merchants on platforms like Shopee and Lazada already pay substantial affiliate commissions. Today, that pool concentrates on professional influencers. Conexple is a Solana protocol that splits the same pool across up to 5 levels of upline consumers — turning loyal customers into participants in the marketing economy without adding new cost to the merchant.

Every rule and every payout is on-chain and publicly verifiable.

Why this is not MLM

MLM concern	Conexple structural answer
Hidden rules	All rules in programs/conexple-protocol, on-chain
Pay-to-join	No fees, no inventory, no membership
Recruitment-driven income	Commission depends on purchases, not recruiting
Endless tiers	5 levels max for direct commission split
Pyramid economics	50% margin cap enforced on-chain
Operator runs with the money	USDC sits in conexple-escrow; payouts protocol-enforced

Architecture at a glance

┌──────────────────┐    ┌──────────────────┐
│ Solana programs  │←CPI│ conexple_network │  Single source of truth
│ (Anchor):        │    │  (Position state)│  for the network state.
│  • protocol      │    └──────────────────┘
│  • network       │
│  • escrow        │    ┌──────────────────┐
│  • oracle        │←───│ Cloudflare       │  Off-chain placement,
└──────────────────┘    │ Workers + D1 +   │  scheduling, oracle
        ▲               │ Durable Objects  │  signing, RPC cache.
        │               └──────────────────┘
        │
   ┌────┴───────────────┐
   │ Next.js on         │  Consumer + operator + merchant + public
   │ Cloudflare Worker  │  explorer views (static export).
   └────────────────────┘

Detailed: docs/architecture.md.

Quickstart

# 1. Clone + install
git clone https://github.com/conexple/alpha
cd conexple
pnpm install

# 2. Local Solana toolchain (WSL Ubuntu recommended on Windows)
solana-keygen new --no-bip39-passphrase -o keys/devnet-deployer.json
solana config set --url devnet --keypair keys/devnet-deployer.json
solana airdrop 5

# 3. Build + deploy programs (one-shot, idempotent)
bash scripts/deploy-devnet.sh

# 4. Seed demo data (1 merchant + 5 wallets + 3-level network)
pnpm seed

# 5. Verify on-chain (writes Solscan link to submission/smoke-receipt.json)
pnpm smoke

# 6. Run frontend + operator locally
pnpm --filter web dev          # http://localhost:3000
pnpm --filter operator dev     # http://localhost:8787 (wrangler dev)

For architecture deep-dive see docs/architecture.md; for protocol mechanics see docs/mechanics.md.

Repo layout

programs/                    Anchor programs (the open protocol)
  conexple-protocol/         rules + verify_placement
  conexple-network/          Position state, register/place/extend/expire
  conexple-escrow/           merchant USDC vaults + payouts + pool
  conexple-oracle/           registered backend signers + audit log

apps/
  web/                       Next.js 15 frontend (Cloudflare Workers — static assets)
  operator/                  Cloudflare Workers backend (Hono + D1 + KV + Queue)

packages/sdk/                shared TypeScript types + PDA helpers

scripts/                     deploy-devnet · init-network · mint-demo-usdc · seed-demo · e2e-smoke
tests/                       Anchor end-to-end happy-path test
submission/                  pitch script · tech demo script · deck outline · receipts

Detailed reading order: docs/architecture.md → docs/mechanics.md → docs/payout.md.

Contributing

This is an open protocol — anyone can fork it and deploy a network for their own use case. For changes to this implementation, open an issue first to discuss; PRs welcome on main.

Security

See SECURITY.md. Smart contracts are unaudited; independent review is welcomed.

License

Apache 2.0 — patent grant included, business-friendly.

Acknowledgements

• Solana Foundation, Anchor maintainers
• Colosseum Frontier 2026 hackathon
• Inspired by GDI Infinity Override; redesigned for an affiliate-only (no recruitment) model

— Conexple contributors · Built in Bangkok, Thailand 🇹🇭