Kadena P2P Marketplace

Part of Kadena Nexus. Live at https://marketplace.kadena.ws. Peer-to-peer KDA trading with the seller's coins held by the free.p2p-escrow-v10 Pact module on chain 1 until the buyer's payment is confirmed; a platform arbiter settles disputes and timeouts.

Built by Mica Dimic (winner of the Kadena Devs escrow challenge, January to April 2026), with contributions from Mirza Muhammad Baig (April 2026) and Mustafa Zahid (contract v6 to v10 fixes, timers, trade warning pop-up; maintainer since April 2026).

• Deploying: see DEPLOY.md. Contract versions: see contracts/README.md.
• The main branch is the current home of the marketplace code. It continues the old Cool-Dev branch (commit 11a381b), which was overwritten by a force-push on 12 Aug 2026 and restored as recovered/Cool-Dev-marketplace.

---

Kadena P2P Escrow

Non-custodial peer-to-peer escrow dApp on Kadena (mainnet01, chain 1). Trades are secured by the free.p2p-escrow Pact module; funds are held in the contract until release or refund.

Features

• Create Offer — Seller creates an offer (ID, amount in KDA). Platform arbiter is set in the contract.
• Accept Offer — Buyer accepts a CREATED offer.
• Deposit — Seller sends KDA to the escrow vault (ACCEPTED → FUNDED).
• Mark Paid — Buyer confirms off-chain payment (FUNDED → PAID).
• Release — Seller or arbiter releases funds to the buyer (PAID → COMPLETED).
• Refund — Arbiter refunds to the seller from FUNDED or PAID.
• Close Offer — Seller closes an offer in CREATED state.
• Wallet-linked profiles — Username, avatar, bio. Create/edit requires proving wallet ownership via a signed message (no editing by entering an address). Public profile at /u/<wallet>. Profile summaries in the offer list and trade screens.

Tech Stack

• Frontend: React, TypeScript, Vite
• UI: Tailwind CSS, shadcn/ui, Lucide, Sonner (toast)
• Chain: @kadena/client (Pact, send, local, poll)
• Wallet: Ecko Wallet (kda_connect, createSignWithEckoWallet)

Prerequisites

• Node.js 18+ and npm (or yarn/bun)
• Ecko Wallet (browser) on Kadena mainnet01, chain 1, with KDA for gas

Run Locally

git clone <YOUR_REPO_URL>
cd Kadena-NEXUS

npm install
npm run dev

For profile features (create/edit, summaries), also run the profile API in another terminal. Profiles are stored in PostgreSQL (off-chain); offers/escrows stay on-chain only.

PostgreSQL Setup

Option 1: Local PostgreSQL Installation

1. Install PostgreSQL from https://www.postgresql.org/download/
2. Create database and run schema:

   psql -U postgres -c "CREATE DATABASE kadena_nexus;"
   psql -U postgres -d kadena_nexus -f server/schema.sql
   

Option 2: Docker (Recommended for Development)

# Start PostgreSQL in Docker
docker run --name kadena-postgres -e POSTGRES_PASSWORD=postgres -e POSTGRES_DB=kadena_nexus -p 5432:5432 -d postgres

# Run schema
docker exec -i kadena-postgres psql -U postgres -d kadena_nexus < server/schema.sql

Option 3: Cloud PostgreSQL (Production) Use services like:

• Supabase (free tier available)
• AWS RDS
• Google Cloud SQL
• Azure Database for PostgreSQL

Start the Server

# With default connection (localhost)
npm run dev:server

# Or with custom connection string
DATABASE_URL=postgresql://user:password@host:port/kadena_nexus npm run dev:server

• DATABASE_URL — PostgreSQL connection string (default: postgresql://localhost:5432/kadena_nexus)
  • Format: postgresql://[user[:password]@][host][:port][/database]
  • Example: postgresql://postgres:postgres@localhost:5432/kadena_nexus

This starts the profile API on port 3001. The Vite dev server proxies /api and /socket.io (WebSocket) to it. If you see ws proxy error: ECONNRESET in the Vite terminal, run npm run dev:server in another terminal so the profile API is up.

App runs at http://localhost:8080. Chainweb is called directly (no proxy): the app uses VITE_CHAINWEB_API or defaults to the community Chainweb API. Override with:

VITE_CHAINWEB_API=https://api.chainweb-community.org/chainweb/0.0/mainnet01/chain/1/pact npm run dev

If you see CORS errors in the browser, the API may not allow requests from your origin; you can try another API or run a small proxy yourself.

Scripts

Script	Description
npm run dev	Dev server (port 8080)
npm run dev:server	Profile API (port 3001)
npm run build	Production build
npm run preview	Preview production build
npm run lint	ESLint

Contract Deployment

The Pact module is free.p2p-escrow-v10 (see CONTRACT_MODULE in src/lib/kadena.ts; must match (module ...) in p2p-escrow.pact). It provides:

• Strict state machine — CREATED → ACCEPTED → FUNDED → PAID → COMPLETED (or REFUNDED/CLOSED/DISPUTED via timeouts or arbiter).
• Timed transitions (only after funded) — T2 (mark paid) and T3 (release / dispute) start once KDA is in escrow. Before funding, creator can close the offer (CREATED or ACCEPTED); no contract time limits pre-fund. Config still stores t1 for compatibility; it is unused for logic.
• Admin — init-config and set-config(arbiter, t1, t2, t3) (GOVERNANCE). GOVERNANCE is restricted: only a signer that satisfies the keyset admin-keyset (provided in tx data) can grant it — so only the admin can upgrade the module or run init/set-config.
• Vault — Per-offer accounts use a capability user guard (not a keyset). Only the module can transfer from vaults (release/refund); see Kadena deprecation notice for module guards.

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗