OIL

OIL is a crypto mining protocol.

API

• Consts – Program constants.
• Error – Custom program errors.
• Event – Custom program events.
• Instruction – Declared instructions and arguments.

Instructions

Mining

• Automate - Configures a new automation.
• Checkpoint - Checkpoints rewards from an prior round.
• ClaimOIL - Claims OIL mining rewards.
• ClaimSOL - Claims SOL mining rewards.
• Deploy – Deploys SOL to claim space on the board.
• Initialize - Initializes program variables.
• Log – Logs non-truncatable event data.
• ReloadSOL - Reloads SOL mining rewards into automation.
• Reset - Resets the board for a new round.

Staking

• Deposit - Deposits OIL into a stake account.
• Withdraw - Withdraws OIL from a stake account.
• ClaimSeeker - Claims a Seeker genesis token.
• ClaimYield - Claims staking yield.

Admin

• Barrel - Executes a buy-and-barrel transaction.
• Wrap - Wraps SOL in the treasury for swap transactions.
• SetAdmin - Re-assigns the admin authority.
• SetFeeCollector - Updates the fee collection address.
• SetFeeRate - Updates the fee charged per swap.

State

• Automation - Tracks automation configs.
• Board - Tracks the current round number and timestamps.
• Config - Global program configs.
• Miner - Tracks a miner's game state.
• Round - Tracks the game state of a given round.
• Seeker - Tracks whether a Seeker token has been claimed.
• Stake - Manages a user's staking activity.
• Treasury - Mints, burns, and escrows OIL tokens.

Tests

To run the test suite, use the Solana toolchain:

cargo test-sbf

For line coverage, use llvm-cov:

cargo llvm-cov