Repository navigation
Releases
Releases · dfinity/cksol
cksol_minter-v0.2.0
- SHA-256 hash:
fd89fec8cb9e9941db7988131efd7a4acbb04a2be9f091524abd0d1a669ebd96
Deployments
| Type | Canister ID | Deployed? |
|---|---|---|
| 🚀 Production | lh22c-kyaaa-aaaar-qb5nq-cai |
❌ |
| 🧪 Staging | ljyxk-riaaa-aaaar-qb5mq-cai |
✅ |
What's Changed
The automatic deposit flow is disabled until automatic_deposit_fee is set, which the upgrade installing this version should do, as described under "Enable the automatic deposit flow" in the deployment guide. Once the flow is enabled, the upgrade can no longer be rolled back: a faulty version has to be fixed forward.
Added
- Automatic deposits:
watch_deposit_addressregisters the deposit address of the caller's account for free and reports on the registration, so that SOL sent straight from an exchange is credited without a further call. A timer scans the watched addresses withgetMultipleAccountson a schedule spread over a day and queues a deposit that reachesminimum_deposit_amountexactly asdeposit_solwould, deducting the newautomatic_deposit_feeinit and upgrade parameter from the minted amount;get_minter_inforeports the fee and the collected fees (#277, #279, #280, #281, #282, #283, #291, #274) - A sweep of automatic deposits that fails or expires puts their addresses back on the watchlist for a fresh window, if it has room, so that the funds are swept again under a new deposit id without any call (#284)
- The watchlist is recorded in a new event before an upgrade, unless it is empty, and restored on replay (#285)
- Observability: metrics for the watched addresses against the capacity of the watchlist, the age of the earliest due scan, the scans by outcome, the re-arms of dropped automatic deposits by outcome and the collected fees, and on the dashboard the fee, the collected fees and the watched addresses (#287)
- ICRC-21 consent messages:
icrc21_canister_call_consent_messagedescribes awithdraw_solrequest, with the amount to burn, the current withdrawal fee, the estimated amount to receive, the destination address and the source subaccount, if any, so that ICRC-21-aware wallets can show it before the user signs.icrc10_supported_standardslists ICRC-10 and ICRC-21. Contributed by robin-liquidium (#295)
Changed
deposit_solreturns the deposit that a scan queued for the same account during its balance read, charging only the read, so that the same balance is never queued twice (#286)- The
dropped_depositsmetric is split by theoriginof the deposit,manualorautomatic(#287)
Reproducible build
The attached cksol_minter.wasm.gz is built reproducibly. To verify the hash matches:
git checkout cksol_minter-v0.2.0
just docker-build
sha256sum wasms/cksol_minter.wasm.gzcksol_minter-v0.1.0
- SHA-256 hash:
21374814ae5ed3063762d53a0a66d9d60524792ae0d30670465172ad9c1273a8
Deployments
| Type | Canister ID | Deployed? |
|---|---|---|
| 🚀 Production | lh22c-kyaaa-aaaar-qb5nq-cai |
✅ Proposal 144313 |
| 🧪 Staging | ljyxk-riaaa-aaaar-qb5mq-cai |
✅ |
What's Changed
First release of the ckSOL minter, which mints ckSOL on the ckSOL ledger for SOL deposited on Solana and sends SOL back when ckSOL is burned. It is deployed on staging against Solana Devnet as ckDevnetSOL.
Added
- Deposit addresses:
get_deposit_addressderives a Solana deposit address for any ICRC-1 account, as an update call so that it can later depend on state without a breaking change. The minter's own main address is derived separately from the master key, so no account can obtain it as a deposit address (#3, #183, #227) - Deposits:
deposit_solreads the finalized balance of the given account's deposit address and queues it for a sweep, charging the attached cycles for the RPC call plus thedeposit_sol_fee. It rejects balances belowminimum_deposit_amount, and a second call while a deposit for the same account is in flight.deposit_sol_statusfollows a deposit throughQueued,Swept,FinalizedandMinted, orDroppedandQuarantinedon the unhappy paths (#5, #25, #208, #210, #211, #212) - Sweeps: a timer sweeps up to ten queued deposits into the main address per transaction. Once the transaction is finalized, the minter checks its outcome against the planned transfers, credits what the main address received and mints ckSOL for each deposit, with the sweep signature and deposit id in the mint memo. Sweeps that fail or expire are dropped and can be retried with
deposit_sol; sweeps whose outcome does not match the plan are quarantined and nothing is minted (#213, #214, #218, #220, #222, #230, #232) - Withdrawals:
withdraw_solburns ckSOL through an ICRC-2 approval and queues a transfer of the amount minuswithdrawal_fee;withdraw_sol_statusreportsPending,TxSentandTxFinalized. Amounts belowminimum_withdrawal_amountare rejected, and so are destinations that could never receive the transfer or would corrupt the minter's accounting: reserved account keys such as sysvars and builtin programs, the minter's main address, and its nonce accounts (#9, #13, #18, #29, #46, #109, #243, #262) - Durable-nonce withdrawals: queued withdrawals are batched up to ten per transaction, each built on a durable nonce account from a pool configured through the init and upgrade arguments, so a withdrawal transaction never expires. Nonce accounts can only be added, and each is verified on read. A transaction that does not reach the chain is re-broadcast unchanged, and a withdrawal is finalized from the state of its nonce account, which unlike the transaction history stays readable indefinitely. Only withdrawals the main address can pay for, including the transaction fee, are submitted (#84, #115, #202, #241, #244, #248, #252, #255, #257, #258, #260)
- Event log: every state change is recorded as an event and replayed on upgrade, and
get_eventsexposes the log. The minter's public key is recorded on first fetch, so it is available immediately after an upgrade (#8, #20, #26, #65, #67, #70, #235) - Configuration: init and upgrade arguments for the SOL RPC canister, the ledger, the threshold key, the Solana network, fees, minimum amounts and nonce accounts, and
get_minter_infoto read them together with the minter's balance and main address (#7, #10, #83, #86) - Observability: structured canister logs, Prometheus metrics at
/metrics, including the age of the oldest in-flight deposit and withdrawal for alerting, and a dashboard at/dashboardwith the minter's metadata, minted and quarantined deposits, and withdrawals (#10, #64, #72, #90, #114, #127, #140, #152, #237) - Reproducible build: the release wasm is built in Docker and its SHA-256 can be checked against the published one (#80)
Fixed
- Trust RPC responses only for what was asked: a
getTransactionresponse must contain the queried transaction, andgetSignatureStatusessearches the transaction history, so a landed transaction is not reported as unknown once it leaves the recent status cache (#236, #239) - Tolerate concurrent first fetches of the master public key, which used to trap the second caller (#226)
- Fixes from a full deposit and withdrawal round trip and a deposit stress test on staging (#263)
Reproducible build
The attached cksol_minter.wasm.gz is built reproducibly. To verify the hash matches:
git checkout cksol_minter-v0.1.0
just docker-build
sha256sum wasms/cksol_minter.wasm.gz