Deployment

How to build, test, and publish the OddsZero Move contracts, and how the frontend is configured for a network.

Prerequisites

• Sui CLI toolchain 1.74.1 or compatible.
• An active Sui environment and a funded address.
• Node.js 18+ for the frontend.

Build & test

cd sui-predict/contracts

# Build the package
sui move build

# Run the full test suite
sui move test

# Coverage
sui move test --coverage
sui move coverage report

# Lint
sui move lint

The test suite (contracts/tests/) covers market creation, trading (AMM), resolution, disputes, price markets, the CLOB, LP incentives, attack surface, seed settlement, protocol invariants, and edge cases (20+ test modules).

Publish

# Point at the target network
sui client switch --env testnet

# Publish (gas budget example)
sui client publish --gas-budget 100000000

The current testnet deployment:

published-at = 0x37573a1060e150e2cbc48ea310e1a05b859dd18541344ffe1c2e304fee702916

Record the new published-at in Published.toml. After publishing, the protocol shared objects must be initialized once (admin): create_treasury, create_vault (incentives), and treasury funded. Capture their object ids.

Testnet tip — minting test collateral. On testnet the real USDC faucet cannot easily supply the 10,000 USDC minimum seed required to create a market. The package ships a deployable mock USDC module (sources/mock_usdc.move, type 0x…::mock_usdc::USDC). Publish the package, then call mock_usdc::mint (publisher-only) to mint as much test USDC as you need — e.g. 10_000_000_000 base units (10,000 USDC) for one market's seed. This is not the real USDC and must never be used on mainnet.

Configure the frontend

Copy .env.example to .env.local and set:

NEXT_PUBLIC_PACKAGE_ID=0x...
NEXT_PUBLIC_REGISTRY_ID=0x...
NEXT_PUBLIC_ADMIN_REGISTRY_ID=0x...
NEXT_PUBLIC_GOVERNANCE_ID=0x...
NEXT_PUBLIC_TREASURY_ID=0x...
NEXT_PUBLIC_INCENTIVE_VAULT_ID=0x...
NEXT_PUBLIC_USDC_TYPE=0x...::mock_usdc::USDC   # testnet mock; use the real USDC type on mainnet
NEXT_PUBLIC_SUI_GRAPHQL_URL=https://sui-testnet.mystenlabs.com/graphql
NEXT_PUBLIC_API_URL=https://your-indexer/graphql
NEXT_PUBLIC_ADMIN_HOST=admin.oddzero.com
NEXT_PUBLIC_CLOCK_ID=0x6   # Sui Clock shared object

Then npm install && npm run build && npm start (see Developer Guide).

Upgrade notes

The package uses Sui's standard upgrade capability (Published.toml records it). On upgrade, shared object ids are stable; only the package id changes for new calls. Re-point NEXT_PUBLIC_PACKAGE_ID after an upgrade.

Example fixtures

contracts/examples/test_markets.json contains sample markets (FOMC rate cut, BTC year-end, US election, championship final, box-office gross) with creator_fee_bps, initial_liquidity, and ends_at_offset_ms — useful for seeding a test deployment.