Acorns for Your Spare Crypto

Created by

B3 Team

Root

Check Token Allowlist

Check Not Output

Allowlist Guard

Get Saved

About

Acorns for your crypto wallet on Base. Auto save the spare change from any incoming ERC-20 payment into cbBTC. For example, if you receive $1.50 in USDC on Base, then $0.50 gets set aside in a spare change pot. Once your pot hits your chosen threshold, it auto-swaps to cbBTC. Tiny transfers below your desired minimum are ignored, so dust and spam payments don't clutter your savings.

Quick Setup:

Import your wallet or use your B3OS Treasury Wallet
Pick the Base tokens you want to round down
Set a minimum - transfers under this amount are ignored, so dust and spam don't clutter your savings
Test and publish!

Preview

allowlist_guard

Action

Condition:{"$and":[{"{{check_allowed.result.output.isAllowed}}":{"$eq":"true"}}]}

Calculate USD Amounts

Action

Code:function transform(input) { const SCALE = 10n ** 36n; function toScaled(s) { s = String(s); const neg = s.startsWith('-'); if (neg) s = s.slice(1); const [intPart, fracPart = ''] = s.split('.'); const full = intPart + fracPart; const shift = 36 - fracPart.length; const val = BigInt(full) * (10n ** BigInt(shift)); return neg ? -val : val; } function fromScaled(v) { const neg = v < 0n; if (neg) v = -v; let s = v.toString().padStart(37, '0'); const intPart = s.slice(0, -36) || '0'; let fracPart = s.slice(-36).replace(/0+$/, ''); if (!fracPart) return (neg ? '-' : '') + intPart; return (neg ? '-' : '') + intPart + '.' + fracPart; } const rawAmount = input.rawAmount; const decimals = Number(input.decimals); const price = input.price; const decimalsFactor = 10n ** BigInt(decimals); const rawScaled = toScaled(rawAmount); const dfScaled = toScaled(decimalsFactor.toString()); const tokenAmountScaled = (rawScaled * SCALE) / dfScaled; const priceScaled = toScaled(price); const usdValueScaled = (tokenAmountScaled * priceScaled) / SCALE; const wholeDollars = usdValueScaled / SCALE; const fractionalScaled = usdValueScaled - (wholeDollars * SCALE); return { decimalsFactor: decimalsFactor.toString(), tokenAmount: fromScaled(tokenAmountScaled), usdValue: fromScaled(usdValueScaled), wholeDollars: wholeDollars.toString(), fractional: fromScaled(fractionalScaled) }; }

Input:{"decimals":"{{get_token_metadata.result.decimals}}","price":"{{check_price.result.output.price}}","rawAmount":"{{root.result.params.value}}"}

Input Type:{"properties":{"decimals":{"type":["string","number"]},"price":{"type":["string","number"]},"rawAmount":{"type":"string"}},"required":["rawAmount","decimals","price"],"type":"object"}

Output Type:{"properties":{"decimalsFactor":{"type":"string"},"fractional":{"type":"string"},"tokenAmount":{"type":"string"},"usdValue":{"type":"string"},"wholeDollars":{"type":"string"}},"required":["decimalsFactor","tokenAmount","usdValue","wholeDollars","fractional"],"type":"object"}

Timeout:5000

Calculate Savings Total

Action

Code:function transform(input) { const SCALE = 10n ** 36n; function toScaled(s) { s = String(s); const neg = s.startsWith('-'); if (neg) s = s.slice(1); const [intPart, fracPart = ''] = s.split('.'); const full = intPart + fracPart; const shift = 36 - fracPart.length; const val = BigInt(full) * (10n ** BigInt(shift)); return neg ? -val : val; } function fromScaled(v) { const neg = v < 0n; if (neg) v = -v; let s = v.toString().padStart(37, '0'); const intPart = s.slice(0, -36) || '0'; let fracPart = s.slice(-36).replace(/0+$/, ''); if (!fracPart) return (neg ? '-' : '') + intPart; return (neg ? '-' : '') + intPart + '.' + fracPart; } const fractional = input.fractional; const price = input.price; const decimals = Number(input.decimals); const storedTotalRaw = input.storedTotalRaw ?? '0'; const decimalsFactor = 10n ** BigInt(decimals); const fracScaled = toScaled(fractional); const priceScaled = toScaled(price); const spareTokensScaled = (fracScaled * SCALE) / priceScaled; const dfScaled = toScaled(decimalsFactor.toString()); const spareRawScaled = (spareTokensScaled * dfScaled) / SCALE; const spareRaw = spareRawScaled / SCALE; const newTotalRaw = spareRaw + BigInt(storedTotalRaw); const newTotalRawScaled = toScaled(newTotalRaw.toString()); const savedTokensScaled = (newTotalRawScaled * SCALE) / dfScaled; const savedUsdScaled = (savedTokensScaled * priceScaled) / SCALE; return { spareTokens: fromScaled(spareTokensScaled), spareRaw: spareRaw.toString(), newTotalRaw: newTotalRaw.toString(), savedTokens: fromScaled(savedTokensScaled), savedUsd: fromScaled(savedUsdScaled) }; }

Input:{"decimals":"{{get_token_metadata.result.decimals}}","fractional":"{{calc_amounts.result.output.fractional}}","price":"{{check_price.result.output.price}}","storedTotalRaw":"{{get_saved.result.rows[0].total_saved_raw || 0}}"}

Input Type:{"properties":{"decimals":{"type":["string","number"]},"fractional":{"type":"string"},"price":{"type":["string","number"]},"storedTotalRaw":{"type":["string","number"]}},"required":["fractional","price","decimals"],"type":"object"}

Output Type:{"properties":{"newTotalRaw":{"type":"string"},"savedTokens":{"type":"string"},"savedUsd":{"type":"string"},"spareRaw":{"type":"string"},"spareTokens":{"type":"string"}},"required":["spareTokens","spareRaw","newTotalRaw","savedTokens","savedUsd"],"type":"object"}

Timeout:5000

Check Token Allowlist

Action

Code:function transform(input) { const eventAddr = String(input.eventAddress || '').trim().toLowerCase(); const list = Array.isArray(input.allowedTokens) ? input.allowedTokens : []; const normalized = list.map(a => String(a || '').trim().toLowerCase()); const isAllowed = eventAddr.length > 0 && normalized.includes(eventAddr); return { isAllowed: isAllowed ? 'true' : 'false', tokenAddress: eventAddr }; }

Input:{"allowedTokens":"{{$props.allowedTokens}}","eventAddress":"{{root.result.raw.address}}"}

Input Type:{"properties":{"allowedTokens":{"items":{"type":"string"},"type":"array"},"eventAddress":{"type":"string"}},"required":["eventAddress","allowedTokens"],"type":"object"}

Output Type:{"properties":{"isAllowed":{"type":"string"},"tokenAddress":{"type":"string"}},"required":["isAllowed","tokenAddress"],"type":"object"}

Timeout:5000

check_minimum

Action

Condition:{"$and":[{"{{calc_amounts.result.output.usdValue}}":{"$gte":"{{$props.minAmount}}"}},{"{{calc_amounts.result.output.fractional}}":{"$gt":0}}]}

check_not_output

Action

Condition:{"$and":[{"{{check_allowed.result.output.tokenAddress}}":{"$ne":"0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf"}}]}

Validate Token Price

Action

Code:function transform(input) { const tokens = Array.isArray(input.tokens) ? input.tokens : []; const first = tokens[0] || {}; const prices = first.prices || {}; const raw = prices.usd; const num = typeof raw === 'number' ? raw : Number(raw); const hasPrice = Number.isFinite(num) && num > 0; return { hasPrice: hasPrice ? 'true' : 'false', price: hasPrice ? String(num) : '0' }; }

Input:{"tokens":"{{get_token_price.result.tokens}}"}

Input Type:{"properties":{"tokens":{"type":"array"}},"required":["tokens"],"type":"object"}

Output Type:{"properties":{"hasPrice":{"type":"string"},"price":{"type":"string"}},"required":["hasPrice","price"],"type":"object"}

Timeout:5000

check_threshold

Action

Condition:{"$and":[{"{{calc_savings.result.output.savedUsd}}":{"$gte":"{{$props.swapThreshold}}"}}]}

check_updated

Action

Condition:{"$and":[{"{{update_saved.result.rowsAffected}}":{"$gt":0}}]}

get_saved

Action

Params:{{$workflowId}}, {{check_allowed.result.output.tokenAddress}}, {{$props.walletAddress}}

Sql:SELECT COALESCE((SELECT total_saved_raw FROM savings_round_down WHERE workflow_id = $1 AND LOWER(token_address) = LOWER($2) AND LOWER(wallet_address) = LOWER($3)), '0') as total_saved_raw

get_token_metadata

Action

Chain:

Base

Token:Check Token Allowlist:output.tokenAddress

get_token_price

Action

Contract Addresses:{{check_allowed.result.output.tokenAddress}}

Platform:base

Vs Currencies:usd

insert_saved

Action

Params:{{$workflowId}}, {{check_allowed.result.output.tokenAddress}}, {{$props.walletAddress}}, {{calc_savings.result.output.newTotalRaw}}

Sql:INSERT INTO savings_round_down (workflow_id, token_address, wallet_address, total_saved_raw) VALUES ($1, $2, $3, $4)

log_save

Action

Saved calc_savings.result.output.spareTokens get_token_metadata.result.symbol ($calc_amounts.result.output.fractional USD) spare change. Jar total: calc_savings.result.output.savedTokens get_token_metadata.result.symbol (~$calc_savings.result.output.savedUsd USD) ┬À threshold: $Prop: swapThreshold USD

log_save_inserted

Action

Saved calc_savings.result.output.spareTokens get_token_metadata.result.symbol ($calc_amounts.result.output.fractional USD) spare change (first time for this token). Jar total: calc_savings.result.output.savedTokens get_token_metadata.result.symbol (~$calc_savings.result.output.savedUsd USD) ┬À threshold: $Prop: swapThreshold USD

log_skip

Action

Skipped: received $calc_amounts.result.output.usdValue USD (under minimum $Prop: minAmount USD, or exact dollar amount with no fractional to save)

log_skip_loop

Action

Skipped: received cbBTC ÔÇö that's the swap destination of this template. Accepting cbBTC would create a swap-to-self loop that Relay rejects. If cbBTC is in your $props.allowedTokens, remove it.

log_skip_price

Action

Skipped: no USD price available from Coingecko for token check_allowed.result.output.tokenAddress on Base. Skipping to avoid garbage math.

log_skip_token

Action

Skipped: token check_allowed.result.output.tokenAddress is not in the allowlist. Add it to $props.allowedTokens to save from it.

log_swap

Action

Swap fired! Swapped calc_savings.result.output.savedTokens get_token_metadata.result.symbol (~$calc_savings.result.output.savedUsd USD) to cbBTC on Base. Tx: swap_to_cbbtc.result.srcTransactionHash

price_guard

Action

Condition:{"$and":[{"{{check_price.result.output.hasPrice}}":{"$eq":"true"}}]}

reset_savings

Action

Params:{{$workflowId}}, {{check_allowed.result.output.tokenAddress}}, {{$props.walletAddress}}

Sql:DELETE FROM savings_round_down WHERE workflow_id = $1 AND LOWER(token_address) = LOWER($2) AND LOWER(wallet_address) = LOWER($3)

root

Action

Chain:

Base

To Address:Prop: walletAddress

swap_to_cbbtc

Action

Swapcheck_allowed.result.output.tokenAddresson

Base

for0xcbb7c0000ab88b473b1f5afd9ef808440eed33bfon

Base

update_saved

Action

Params:{{calc_savings.result.output.newTotalRaw}}, {{$workflowId}}, {{check_allowed.result.output.tokenAddress}}, {{$props.walletAddress}}

Sql:UPDATE savings_round_down SET total_saved_raw = $1 WHERE workflow_id = $2 AND LOWER(token_address) = LOWER($3) AND LOWER(wallet_address) = LOWER($4)

Loading chat...