Skip to main content

Overview

The Global Configuration manages program-wide settings including the admin address, fee wallet, protocol fees, and global pause state.

Account Structure

PDA Seeds: ["global_config"]

Protocol Fees

protocol_fees_bps and spread_protocol_fees_bps store the global fee settings. An optional capital provider protocol-fee configuration can override these defaults. The configured fee_token_mint must have a valid swap AssetConfig, a global fee-vault ATA, and funded capital provider fee-token ATAs before swaps can use it. Protocol fees are paid from the capital provider fee-token ATA. The Swap Instruction page describes fee calculation and settlement.

Pause State

When paused is true, swaps, liquidity operations, fee claims, init_pair, update_pair, close_pair, close_lp_fee_account, and close_treasury_position are blocked. The Security & Access Control page describes all pause levels and their effects.

Fee Collection

Protocol fees accumulate in the program_authority-owned fee-vault ATA. claim_fees transfers the accumulated tokens to the configured fee_wallet and leaves the fee vault open for future collection. The program must be unpaused.
While anyone can trigger fee claims, the fees are always sent to the fee_wallet configured in GlobalConfig, not to the caller.

Admin Authority

The admin controls global configuration, asset acceptance, and protocol fees. Admin transfer requires confirmation from the proposed new admin; the current admin remains in control until confirmation. The Security & Access Control page describes the permission model.

Error Codes


Treasury Configuration

Treasury maintains a separate GlobalConfig at ["GLOBAL_CONFIG"] under the Treasury program. Its manager controls the oracle authority, management fee, pause state, APY history retention, unposted-yield limit, and pending-deposit capacity. The oracle_authority posts completed daily rates. The program deducts management_fee_bps from gross APY, with a floor of zero, and stores the net rate. New days are posted in order. The manager sets the gross APY ceiling. The full Treasury account and instruction definitions are included in the Program IDL.

Next: Asset Configuration

Learn about per-token NAV configuration and asset management