Skip to main content

JACK Smart Contracts

Overview​

The JACK protocol is powered by a suite of smart contracts built on Uniswap v4 that enable intent-based cross-chain execution with policy enforcement and secure settlement.

Core Contracts​

JACKSettlementAdapter​

Status: ✅ Production Ready

The settlement adapter is the primary interface for executing user intents on-chain. It integrates EIP-712 signature validation, solver authorization, and atomic swap execution through Uniswap v4.

Key Capabilities:

  • Validates signed user intents
  • Authorizes solver network
  • Executes atomic token swaps
  • Integrates with policy enforcement
  • Provides reentrancy protection

View Full Documentation →

JACKPolicyHook​

Status: 🚧 Development

The policy hook enforces protocol rules and risk management constraints on intent settlement. It validates intents before execution to ensure compliance with system policies.

Key Capabilities:

  • Intent validation
  • Volume limits
  • Rate limiting
  • Token allowlists
  • Risk thresholds

Documentation coming soon.

Architecture​

Contract Addresses​

Testnet​

Coming soon - contracts are currently in development.

Mainnet​

Not yet deployed - production launch pending.

Development​

Setup​

Clone the repository and install dependencies:

git clone https://github.com/hashpass-tech/JACK.git
cd JACK/contracts
forge install

Build​

forge build

Test​

forge test

Deploy​

Deployment instructions are available in the internal operations documentation at /docs/operations/contracts-deployment.md in the repository.

Security​

Audits​

  • External security audit (planned)
  • Bug bounty program (planned)

Testing​

All contracts include comprehensive test suites covering:

  • Happy path functionality
  • Error cases and reverts
  • Security boundaries
  • Reentrancy protection
  • Access control

Best Practices​

  • Uses OpenZeppelin battle-tested libraries
  • Follows Checks-Effects-Interactions pattern
  • Implements reentrancy guards
  • Validates all external inputs
  • Emits events for state changes

Resources​

Contributing​

We welcome contributions to the JACK smart contracts. Please ensure all changes include:

  1. Comprehensive tests
  2. Clear documentation
  3. Gas optimization considerations
  4. Security review

See our Contributing Guide for more details.