AutoStable

AutoStable is an optional settlement feature that automatically converts volatile token donations (ckBTC, ckETH, ICP) into a stablecoin of your choice as each donation settles.

Stablecoins (ckUSDC, ckUSDT) are always received as-is and are never touched by AutoStable.

What AutoStable does

When a donor gives with a volatile token and AutoStable is enabled for that token, Pybara executes an on-chain swap and delivers a stablecoin to your recipient wallet instead. The swap happens automatically with no manual steps on your end.

Requirements

• Pybara Wallet must be your recipient wallet. AutoStable is available only to recipients receiving donations into Pybara Wallet.
• One-time per-token approval. The first time you enable AutoStable for a token, Pybara requests a standing ICRC-2 allowance from your wallet. This is a one-time on-chain action per token. Under $0.10 worth of that token needs to be present in your wallet to cover the ledger fee for the approval — only this fee is consumed, not the approval amount itself.

To revoke an approval, set the token back to Hold and save. The plugin will prompt you to confirm the on-chain revocation.

Not the same as a recurring pledge approval

This is your own approval as the recipient. It is unrelated to the ICRC-2 spending approval a donor grants when setting up a recurring donation, which the donor controls from their own wallet.

---

Cost

AutoStable charges 1% of the converted amount, on top of the swap cost charged by the DEX.

• The AutoStable fee is separate from your platform (commission) fee.
• The swap cost depends on market conditions at the time of each settlement.
• You are charged the cost actually incurred, never the cap you set.
• If a swap is skipped due to the cost cap (see below), no AutoStable fee is charged.

---

Capping the cost

You set a maximum total cost you are willing to pay for a conversion, covering both the swap cost and the 1% AutoStable fee. Available caps: 2%, 3%, 4%, 5%. The default is 3%.

If the cost would exceed your cap:

• The swap is skipped entirely.
• You receive the original volatile token in full, with no AutoStable fee charged.
• An optional email notification is sent (see below).

How the cap is enforced

The cost is checked twice, independently: once when the conversion is initiated, and again at the moment of execution.

A DEX executes against a live pool, so the final cost of a swap can differ from the cost measured immediately beforehand — another trade landing in the same pool moves the price. To make sure that movement can never push you past your cap, a margin equal to the DEX slippage tolerance is reserved against your cap at both checks.

The effect is a hard guarantee: if your cap is 3%, the cost of a conversion you receive will never exceed 3%, whatever the market does between the check and the swap.

Why a swap can be skipped below your cap

Because the margin is reserved at both checks, a conversion costing slightly less than your cap may still be skipped. A swap estimated at 2.8% against a 3% cap will not go through — at execution it could have landed above 3%, and the guarantee holds instead.

The slippage tolerance is currently 0.3% (30 basis points). It is an internal parameter of the conversion service and is not configurable per recipient.

The 2% cap is restrictive

At a 2% cap, the 1% AutoStable fee, the DEX pool fee, and the reserved slippage margin leave very little headroom. Most conversions will be skipped. Choose 2% only if you would genuinely rather hold the volatile token than convert it at anything above that cost.

Recurring donations

Each donation is evaluated on its own, including every renewal of a recurring pledge. Depending on market conditions at the time, some renewals of the same pledge may convert while others are skipped.

---

Skip notifications

When a swap is skipped, Pybara can send you an email alert.

Enable the Send me an email if skipped toggle and enter an address. The notification includes the token, the donation amount, and the reason the swap was skipped.

This setting is optional and applies to your site as a whole, not to individual tokens.

---

Receive as

When a swap executes, you choose which stablecoin you receive:

• Best quote (default) — Pybara routes to whichever of ckUSDC or ckUSDT offers the better rate at the time of settlement.
• ckUSDC — always settle to ckUSDC.
• ckUSDT — always settle to ckUSDT.

Best quote gives a conversion the best chance of landing under your cap, since it takes whichever of the two stablecoins is cheaper to reach at that moment.

---

Where to see the cost

Every conversion is itemised against its donation in Pybara Wallet: the token converted, the token received, the swap cost, and the AutoStable fee.