Mining
Mining is the Satcoin (SAT) runtime control surface. Fased Agent runs the Satcoin mining workflow 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
- 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
- Operator glossary for shared terms across wallet, mining, Fased Network, bond, and payment
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 site
Use the official Satcoin site for launch status and public references.
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 submits the
safe value while keeping the saved target available for later cycles.
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
You do not normally activate mining by enabling the bundled plugin manually.fased plugins enable sat-mining only controls plugin loading; it does not start
mining. Start from the Mining wallet and readiness flow below.
Use this flow before pressing Start for the first time:
- Create a dedicated signer-owned Mining wallet in Wallets or with
fased wallet create --role mining; import withfased wallet importfrom the native Local or Hosting operator terminal. - Enter one primary RPC. The signer activates the release-bound Mining role baseline and reports exact policy/network readiness.
- Only then copy the Mining address and fund it with a deliberately small amount of SOL for fees, reserve, and intended capital.
- Open Mining and confirm the wallet shown is
@wallet:mining. - Check official mainnet status. The manifest verification public key belongs to the Fased release, not to your wallet; no wallet is required to check it.
- Run readiness. Fix signer, RPC, policy, 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: 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 the saved upper bound. 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. You do not need a model provider to mine.Deterministic execution runs the
wallet, readiness, capital, commit, cycle submission, settlement, and claim
path locally. A configured model is optional: it can guide Auto allocations
or run guarded Mining strategy-review tasks, but it never replaces wallet
policy or transaction approval.
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 eligibility commit:
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 signer-owned Mining wallet through the native operator lifecycle
- enter one primary RPC and verify role baseline v1
- enroll signer WebAuthn for manual reviewed Mining actions
- confirm exact policy/network hashes and readiness
- fund the wallet deliberately small and 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
Retire and replace a Mining wallet
Do not archive a Mining wallet and reuse its ID. Stop Mining, let clearing and claims finish, move recoverable funds, and create an encrypted recovery package. Then run the native operator command: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
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.