> ## Documentation Index
> Fetch the complete documentation index at: https://hypernova.xyz/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Smart Contract

> Every account, every rule, every payout - recorded on-chain

Hypernova records your trading lifecycle on-chain. Your assessment account, your funded account, the rules you trade under, the agreement you sign, and every payout you take are written to public smart contracts on Arbitrum that anyone can audit.

Hypernova runs the trading, risk, and settlement systems - but every account action is anchored on-chain, so you can independently verify your rules, equity, and payouts instead of taking our word for them.

***

## What Lives On-Chain

<CardGroup cols={2}>
  <Card title="Every account" icon="id-card">
    Both assessment and funded accounts are created as records on the smart
    contract. There is no hidden ledger.
  </Card>

  <Card title="Every rule" icon="ruler">
    Drawdown limits, profit targets, daily loss caps and starting balance are
    written into the contract when your account is created.
  </Card>

  <Card title="Every signature" icon="signature">
    Accepting your funded-trader agreement produces a cryptographic signature
    that is verified on-chain before your account goes active.
  </Card>

  <Card title="Every payout" icon="receipt">
    Profit splits, transaction hashes, vault balances - published to the chain
    in real time and queryable by anyone.
  </Card>
</CardGroup>

***

## Account Creation

When you fund your wallet and start an assessment, Hypernova opens your account and writes it to the contract on Arbitrum. The on-chain record is permanent and public - anyone can read the exact rules your account was opened under.

<Steps>
  <Step title="Assessment account opens">
    A unique on-chain account is created for your assessment. Your starting
    balance, profit target, daily loss limit, and max drawdown are written in at
    this moment.
  </Step>

  <Step title="Rules are recorded on-chain">
    The risk parameters that define your assessment - starting balance, profit
    target, daily loss limit, and max drawdown - are written to the contract
    when your account opens, so the terms you're judged against are public and
    auditable from day one.
  </Step>

  <Step title="Pass the assessment, get a funded account">
    On a successful assessment, the contract opens a separate funded account
    record with its own identifier. Your assessment account stays in place as a
    permanent record.
  </Step>
</Steps>

<Info>
  This means anyone - you, us, a third party - can query the chain and see the
  exact rules your account was opened under, independently of our dashboard.
</Info>

***

## The Funded-Trader Agreement

Before your funded account becomes active, you sign the funded-trader agreement. The signature isn't a checkbox in a database - it's a cryptographic signature produced by your wallet and verified by the contract.

<CardGroup cols={2}>
  <Card title="You sign with your wallet" icon="key">
    The agreement text is hashed, and your wallet signs the hash. Only the
    holder of your wallet's private key could have produced that signature.
  </Card>

  <Card title="The contract verifies it" icon="check-double">
    Before your funded account activates, the contract checks the signature
    against your wallet address. A mismatch means activation fails.
  </Card>

  <Card title="The agreement hash is on-chain" icon="link">
    The exact version of the agreement you signed is identifiable from the chain

    * we can't show you one set of terms and apply a different set later.
  </Card>

  <Card title="Single signature, no gas for you" icon="bolt">
    You sign once in-app. Hypernova sponsors the gas to record the signature
    on-chain.
  </Card>
</CardGroup>

***

## Payouts on the Same Contract

Every payout is processed on-chain. The contract enforces your profit-share split and won't release more than your earned profit, and each payout is recorded with a transaction hash. Payouts are automated - no manual approval queue.

| Property             | Guarantee                                                                       |
| -------------------- | ------------------------------------------------------------------------------- |
| **Profit split**     | Encoded in the contract - your share is calculated and released atomically      |
| **Withdrawable cap** | The contract refuses to release more than your earned profit, even if requested |
| **Authorisation**    | A wallet signature from you is required for every payout                        |
| **Receipt**          | Every payout emits an on-chain event with the transaction hash                  |
| **Gas**              | Sponsored by Hypernova                                                          |

See [Payouts](/payouts) for the user flow and [Funding Your Wallet](/funding-wallet) for how USDC reaches your wallet in the first place.

***

## The Public Vault

The capital that backs funded accounts is held on-chain - in the Vault contract that settles payouts, topped up from a public reserve wallet. Both balances are live and queryable; see [Active Addresses](#active-addresses) for the exact addresses.

<CardGroup cols={2}>
  <Card title="Live balance" icon="eye">
    The reserve isn't a number we publish in a quarterly report - it's an
    on-chain balance you can read at any time.
  </Card>

  <Card title="Auditable history" icon="clock-rotate-left">
    Every top-up of the reserve and every payout out of the Vault is on-chain.
    The full history is permanent and reconstructable from the network.
  </Card>
</CardGroup>

***

## Self-Custody by Default

Your Hypernova wallet is yours - the platform can't move funds out of it without your signature. What you self-custody is your **wallet**: the USDC you deposit, the profit share paid to you, and any withdrawal out. The **funded trading capital itself is provided by Hypernova** - it isn't deposited by you, and it isn't held in your wallet.

<CardGroup cols={2}>
  <Card title="No custodial model" icon="user-shield">
    Hypernova never holds your private keys. Every fund movement - deposit,
    payout, withdrawal - needs your authorisation.
  </Card>

  <Card title="Signed, then settled" icon="file-signature">
    Deposits, withdrawals, and payouts all follow the same pattern: you sign
    in-app, the network settles. Your authorisation is verifiable on-chain.
  </Card>
</CardGroup>

***

## What This Means for You

<CardGroup cols={3}>
  <Card title="No silent rule changes" icon="lock">
    The rules your account opened under are recorded on-chain, so any change to
    them is publicly visible - nothing happens off the record.
  </Card>

  <Card title="No manual approval queue" icon="wallet">
    Payouts settle in seconds - no support ticket, no waiting period. The
    contract caps every withdrawal at your earned profit.
  </Card>

  <Card title="Independently verifiable" icon="binoculars">
    Don't just trust the dashboard - read the same records on-chain and confirm
    them yourself.
  </Card>
</CardGroup>

***

## See It For Yourself

The Payouts page in your dashboard shows a live feed of every smart-contract interaction tied to your accounts - not just payouts, but every on-chain event the platform makes on your behalf:

* Account creation (assessment + funded)
* Equity updates as you trade
* Pass-eval transitions
* Status changes (suspensions, breaches, settlements)
* Payouts

Each row links straight to Arbiscan with the transaction hash, so you can verify any event independently without trusting the dashboard.

***

## Network Details

| Detail               | Value                                                          |
| -------------------- | -------------------------------------------------------------- |
| **Network**          | Arbitrum (Arbitrum One)                                        |
| **Settlement asset** | USDC                                                           |
| **Gas**              | Sponsored by Hypernova for all platform actions                |
| **Wallet**           | Embedded - created automatically at signup, fully owned by you |

<Info>
  Curious about the rules themselves? See the [Rulebook](/rulebook) for the full
  set of trading rules and the parameters that get written into your account.
</Info>

***

## Active Addresses

Hypernova runs on two **smart contracts**, backed by one **Hypernova-controlled reserve wallet**. All three live on Arbitrum One and can be inspected on Arbiscan at any time.

### Smart contracts

These enforce the rules in code. Anyone can read them, and Hypernova can't alter your recorded rules or release more than your earned profit off-chain.

<CardGroup cols={2}>
  <Card title="TradingAccounts" icon="id-card" href="https://arbiscan.io/address/0x429d8f223acb622e5e748f6a7bdf1235b2334fcb">
    `0x429d...4fcb` - holds every assessment and funded account: the rule
    parameters they were opened under and each equity update.
  </Card>

  <Card title="Vault" icon="shield-halved" href="https://arbiscan.io/address/0x920973eebffd3bf7da14dd9fb52bd3bea1664c67">
    `0x9209...4c67` - settles payouts. Enforces your profit-share split and
    won't release more than your earned profit.
  </Card>
</CardGroup>

### Reserve wallet

<Card title="Payout reserve (Hypernova-controlled)" icon="building-columns" href="https://arbiscan.io/address/0x43c5f0a81d538a527dbf35d27faa583ac7fada07">
  `0x43c5...da07`
</Card>