Mining
Mining is the Satcoin (SAT) runtime control surface. Fased Agent is the first-class runtime for Satcoin agent-operated mining: application-layer mining for agent-operated infrastructure on Solana. Use it to:- confirm the active
@wallet:miningruntime wallet - check readiness before starting
- initialize miner capital
- deposit or withdraw capital
- choose strategy posture
- set the active commit amount
- start or stop the Satcoin runtime
- understand cycles, claim, sweep, and recovery
- coordinate the same operations from chat or channels with
@mining
- Operator glossary for shared terms across wallet, mining, Fased Network, bond, and payment
- Wallet for funding, manual sends, approval, and wallet security
- Solana RPC setup for reliable RPC before long-running mining
- Mining Chat and Automation for
@miningcommands, scheduled mining, and channel control - Fased Network for bond posture and public-network state
Read path
Use this page for first operation and daily checks.Mainnet Sync
Sync official SAT mint and program IDs after launch proof is published.
Advanced mining
Tune strategy, auto mode, claim, sweep, recovery, workers, and history.
Mining troubleshooting
Diagnose low commit, locked capital, fee reserve, skipped cycles, claim backlog, and RPC errors.
Mining API
Inspect routes, gateway methods, config fields, account state, and protocol constants.
Satcoin source
Verify the public Satcoin program source used by the mining runtime.
Satcoin docs
Use Satcoin docs for protocol constants, economics, addresses, and launch proof.
Satcoin docs and Fased Agent
Fased Agent owns the mining wallet UX, signer controls, readiness checks, capital controls, claim flow, sweep, recovery, and operator automation. Satcoin docs own protocol truth:- official mint and program IDs
- signed mainnet manifest
- IDL hash
- emission, erosion, treasury, and staking constants
- launch proof and explorer links
config/sat-runtime.env. After the official Satcoin launch
notice appears in the docs and official announcement channels, click Sync in
the Mining page top bar. Sync verifies the signed mainnet manifest before it
writes the SAT mint and program IDs locally.
How Mining fits into the stack
Read it like this:- Wallet prepares and funds the mining wallet
- Mining uses that wallet for capital, commit, cycles, and claim
- claimed Satcoin can stay in the mining wallet or sweep elsewhere
- Fased Network and bond are separate later layers on top of the wider Satcoin stack
What you see on this page
The Mining page is organized around live operation.1. Header status and start or stop
This is where you:- start mining
- stop mining
- see whether the runtime is ready, running, blocked, or waiting
2. Mining summary cards
The top cards show the operator numbers that matter most:- mining wallet
- wallet Satcoin
- capital
- locked capital
- withdrawable capital
- target max
- safe commit
- active commit
capitalis SOL deposited into the miner capital PDA, separate from wallet SOLlockedis capital tied up in pending or live cycleswithdrawis free capital that can leave nowtarget maxis your saved upper limit for latersafe commitis what the agent can safely use right nowactive commitis what the protocol currently sees in your capital PDA
Your commit, SOL in cycle, locked capital, and fee reserve together.
3. Mining capital
This is the main operator block for:- deposit capital
- withdraw capital
- update active commit
- review the capital account and cycle state
Update sends the transaction
that changes active commit in the miner capital PDA.
If the target is larger than the safe commit right now, Update uses the safe
value instead of forcing the saved target lower.
When the submitted commit is lower than the saved target, check locked capital
and fee reserve first. A smaller safe submit is usually better than missing the
cycle entirely. See Mining troubleshooting.
4. Recent activity and history
Use this to confirm what the runtime did:- participation
- finalization
- claim
- RPC failures
- missed cycles
- fee or gap events
5. Recovery
Recovery is for blocked or disputed state. Use it only after you understand the blocker.Before you start mining
Healthy mining usually requires all of these:- a dedicated Solana mining wallet
- signer healthy
- Solana RPC healthy
- miner capital initialized
- funded capital available
- token account readiness
- a dedicated
@wallet:miningruntime wallet
0.005 SOL as the floor, but long-running mining should keep more than that on hand for fees and buffer.
Beginner start sequence
Use this flow before pressing Start for the first time:- Open Wallets and create or import a dedicated Mining wallet.
- Copy the Mining wallet address and fund it with enough SOL for fees, reserve, and the capital you intend to deposit.
- Open Mining and confirm the wallet shown is
@wallet:mining. - Run readiness. Fix signer, RPC, SOL, token-account, or capital warnings before continuing.
- Deposit a small amount of SOL into miner capital. The Fund action creates the wallet-scoped miner account on-chain when it is missing.
- Set a conservative commit amount lower than the free capital and wallet fee reserve.
- Click Update to write the active commit.
- Click Start only after readiness is green and the fee warning is clear.
Mining terms that matter
The Mining page uses a few terms repeatedly:| Term | Meaning |
|---|---|
| Mining wallet | dedicated Solana wallet configured as @wallet:mining |
| Capital | SOL deposited into the miner capital PDA |
| Locked | capital tied to pending or live cycles |
| Withdraw | free capital that can withdraw or support future commits now |
| Target max | saved upper commit limit for later |
| Safe commit | usable now after locks, reserve, fees, buffer, and erosion |
| Active commit | current commit stored in the miner capital PDA |
| Cycle | current Satcoin participation window |
| Erosion | per-cycle SOL cost applied to committed capital |
| Rebate | miner-side SOL returned by deterministic and performance rebate routing |
Target max is not a promise that every cycle will submit that amount. The
runtime can submit less when capital is locked, wallet fee reserve is low,
erosion coverage is tight, recovery buffer is retained, or stale-RPC guards
block the full target.
If target is 9.9 SOL and a cycle submits 0.8 SOL, inspect Locked,
Withdraw, Safe commit, worker reason, and recent claim state before changing
strategy. The lower submit can be correct while the target remains saved for
later.
For detailed examples, read Mining troubleshooting
and Advanced Satcoin mining.
How to choose a strategy
Mining supports both preset posture and execution mode.Strategy presets
Current presets are:SpreadWider center-weighted coverage for steadier participation and lower concentration risk.BalancedModerate concentration and practical upside with less volatility than aggressive posture.ConvictionTighter concentration around strongest buckets for more variance and more upside if the read is right.SwarmCoordination-friendly clustered coverage that keeps the miner flexible without fully flattening conviction.Top-KSparse high-conviction compiler that chooses a small ranked bucket set.RankedConverts deterministic bucket ranking into weighted exposure with a tail.AdaptiveBlends stable coverage with cycle-ranked opportunity and fallback safety.Crowd-awareKeeps broader tail exposure to reduce crowding risk.Safe fallbackUses the balanced deterministic allocation for recovery or low-confidence operation.
Execution mode
Current execution paths are:DeterministicUses the locked 25-bucket allocation arrays for the selected posture and does not require model inference.AutoUses the model-guided strategy path when available and falls back to deterministic execution if the strategy step fails. The protocol still receives one dense 25-bucket allocation vector and scores it on-chain.
Task shortcut beside Strategy and Execution.
It opens the Agent Task dialog with the Mining strategy review template already
filled. That task is strategy-only: it can inspect Mining status/history and
change strategy fields, but it must not change capital, target max, funding,
withdrawals, wallet sends, bond actions, or start/stop state.
Mining history includes strategy analytics for settled cycles. Use it to compare
which strategies were used most, which averaged the most SAT, which averaged the
most miner rebate, and which had the best net SOL result. When the settled
cycle record has protocol score fields, the analytics also show deterministic
rebate, performance rebate, score edge versus benchmark, skill score, crowding,
and pool size.
Choosing a strategy
Use this rule:- start with
Balanced+Deterministic - choose
Spreadif you want lower concentration and steadier participation - choose
Convictiononly if you accept higher variance - choose
Swarmwhen you deliberately want the clustered coordination posture - choose
Top-K,Ranked,Adaptive, orCrowd-awareonly when you want the compiler to change the 25-bucket shape - use
Safe fallbackwhen you want the most conservative valid allocation while recovering or testing - choose
Autoonly after the base runtime is stable and you actually want model-guided placement
How much SOL to keep in the wallet
There are two separate SOL pools to understand:- wallet SOL for reserve and fees
- miner capital for cycle participation
- minimum commit target:
0.25 SOL - minimum wallet reserve target:
0.15 SOL
Leave at least X SOL in Wallet for cycle creation and fees
nextSubmitCycleSignerLamports- against what the signer can actually spend now
- keep the mining wallet above the reserve target
- leave extra headroom for tx fees
- do not expect the full funded balance to be usable while cycles are locked
Start path
The clean operator sequence is:- create or import the single Mining wallet in onboarding or wallet CLI
- confirm readiness
- initialize miner capital if missing
- deposit SOL into miner capital
- set a target commit
- click
Updatewhen you are ready to update the active commit PDA - confirm wallet reserve and fee buffer
- click
Start
Stop path
Stop means:
- the runtime stops new cycle submits
- claim and recovery can keep running until locked capital is free
- it does not instantly free capital already tied to pending or live cycles
- the page may show
Clearingwhile claim and recovery finish the older cycle work
- stop first if you want to halt new participation
- wait for locked capital to clear as cycles settle
- withdraw only the free capital that is actually available
- click
Resumeif you want new cycle submits to start again - no extra stop action is needed while the page is already clearing; new submits are already off
| Button | Meaning |
|---|---|
Stop | stop future cycle submits; already-submitted cycles still settle and claim |
Resume | exit clearing and allow new cycle submits again |
Ready.
Claim and sweep
Claiming and sweeping are separate settings.Claim mode
Current miner profile values are:autopromptmanual
autofor normal stable miner claimpromptfor advanced review/recovery profiles that support itmanualfor deliberate testing or recovery-oriented claim review
Claim backlog
The Mining page shows aClaims counter when settled cycles still need miner
claim work. The runtime keeps that backlog durably by cycle id, retry
count, last error, and last transaction hash, then claims the oldest ready
cycles first.
The hidden operator cap is automation.claimBatchCycles. It defaults to 5 and
is capped at 16 so staged operator tests can compare 5, 8, 10, 12,
and 16 without changing the beginner UI.
Manual recovery commands:
Satcoin sweep
Post-claim sweep supports:- destination runtime wallet id
- destination external Solana address
allorpercentagemode- minimum sweep threshold
- keep-after-sweep balance
- keep the mining wallet as a working wallet
- sweep excess Satcoin out after claim
- do not let the mining wallet become long-term treasury storage
Common states and errors
Need SOL
The mining wallet does not have enough SOL for readiness or next-round work. Fix:- fund the wallet itself, not just the capital account
Needs setup
Miner setup or capital initialization is still missing. Fix:- initialize capital first
Need free capital
There is not enough free miner capital to enter the next cycle. Fix:- deposit more capital
- or lower commit
Capital locked
Most capital is still tied up in pending cycles. Fix:- wait for the pending range to settle before expecting withdrawable capital
Blocked
Mining is blocked because of signer, RPC, dispute, or unresolved cycle state. Fix:- read the blocker first
- use Recovery only after you know which state is broken
Best practices
- keep Agent, mining, and Vault bond authority separate
- keep a private RPC provider for long-running mining if public RPC starts degrading
- start with balanced deterministic strategy
- keep claim and sweep intentional
- treat the mining wallet as a working wallet, not storage
- leave SOL in the mining wallet for reserve and fees
- do not push active commit to the full capital balance just because the number is available
CLI quick reference
--json and read the API map in Satcoin mining API and protocol.
For chat/channel automation, use Mining Chat and Automation.