feat(swap-widget): swap from any wallet via a deposit address - #12594

Open

kaladinlight wants to merge 83 commits into

feat/external-wallet-deposit-flow

Commits on Aug 13, 2026

feat(swapper): expose deposit-address capability and accessor

kaladinlight
and
claude
committed
632bfc9
feat(public-api): flag deposit-address swappers on rates

kaladinlight
and
claude
committed
2650595
feat(public-api): return the deposit address on externally payable quotes

kaladinlight
and
claude
committed
0509224
feat(public-api): track deposit-address swaps without a client tx hash

kaladinlight
and
claude
committed
8c9770e
feat(swapper): surface the deposit tx hash on deposit-address swaps

kaladinlight
and
claude
committed
ba35629
feat(swap-widget): add deposit-flow contract types and predicates

kaladinlight
and
claude
committed
c1be49f
feat(swap-widget): validate tron, sui, near, starknet and zcash addresses

kaladinlight
and
claude
committed
9e3b747
feat(swap-widget): add awaiting_deposit machine states

kaladinlight
and
claude
committed
c4fe42c
feat(swap-widget): collect a send address when no wallet is connected

kaladinlight
and
claude
committed
175a741
feat(swap-widget): offer a wallet-free deposit from the input step

kaladinlight
and
claude
committed
a0d2913
feat(swap-widget): quote deposits with the user's refund address

kaladinlight
and
claude
committed
0f3ff4b
feat(swap-widget): add the deposit address screen

kaladinlight
and
claude
committed
55829e0
feat(swap-widget): poll deposit swaps through the api

kaladinlight
and
claude
committed
0c3264d
feat(swap-widget): restore a pending deposit across reloads

kaladinlight
and
claude
committed
3d06279
docs(swap-widget): document the external wallet deposit flow

kaladinlight
and
claude
committed
6d1d293
docs(public-api): sharpen the deposit-address field descriptions

kaladinlight
and
claude
committed
991ce5c
fix(swap-widget): group the receive and refund fields into one card

kaladinlight
and
claude
committed
16bd286
fix(swap-widget): restore a pending deposit completely

kaladinlight
and
claude
committed
a97e871
fix(swap-widget): label and make copyable both deposit values

kaladinlight
and
claude
committed
035cc71
fix(swap-widget): keep tracking a deposit past the countdown

kaladinlight
and
claude
committed
675d30b
feat(public-api): allow shortening quote deadlines locally

kaladinlight
and
claude
committed
97988e7
fix(swap-widget): stay on the deposit screen while replacing an address

kaladinlight
and
claude
committed
28bc221
fix(swap-widget): give the expired and re-quoting states the step screen treatment

kaladinlight
and
claude
committed
ccec079
fix(swap-widget): don't imply an expired quote's rate carries over

kaladinlight
and
claude
committed
338415e
fix(swap-widget): name the expiry and its action consistently

kaladinlight
and
claude
committed
6854bed
fix(swap-widget): treat an expired deposit address as a funds risk

kaladinlight
and
claude
committed
667e090
fix(swap-widget): drop the restated warning while re-quoting

kaladinlight
and
claude
committed
c1838aa
chore(public-api): remove the local quote deadline override

kaladinlight
and
claude
committed
5ac1ff0
fix(swap-widget): don't show a typed address as a connected wallet

kaladinlight
and
claude
committed
57d38f2
refactor(swap-widget): call the typed address a refund address

kaladinlight
and
claude
committed
7651496
refactor(swap-widget): drop the unread refund address from wallet context

kaladinlight
and
claude
committed
72ef370
fix(swap-widget): stop wiping the pending deposit before it's restored

kaladinlight
and
claude
committed
6344817
fix(swap-widget): don't flash the input step before a restored deposit

kaladinlight
and
claude
committed
957f2ba
fix(public-api): accept the nulls swap-service returns for swap status

kaladinlight
and
claude
committed
3d7ad0a
refactor(swap-widget): tighten branch comments to one line each

kaladinlight
and
claude
committed
911083b
feat(swap-widget): encode the amount in the deposit QR

kaladinlight
and
claude
committed
8a70731
fix(swap-widget): give cosmos sdk deposits a payment uri too

kaladinlight
and
claude
committed
805e272
refactor(utils): share the payment uri builder

kaladinlight
and
claude
committed
4c4aed5
feat(swap-widget): show the sell network in the deposit QR

kaladinlight
and
claude
committed
9a3ebf0
fix(utils): emit the dogecoin uri scheme Dogecoin Core registers

kaladinlight
and
claude
committed
0e9a932

Commits on Aug 14, 2026

refactor: rename the capability to supportsExternalPayment

kaladinlight
and
claude
committed
701ec1e
refactor(swapper): move getDepositAddress alongside the other helpers

kaladinlight
and
claude
committed
9ca4631
docs(public-api): tighten the deposit-related field descriptions

kaladinlight
and
claude
committed
9e7ddb4
docs: finish the externally-paid rename across prose

kaladinlight
and
claude
committed
530d4b0
refactor(public-api): name the upstream status distinctly

kaladinlight
and
claude
committed
d2160d9
test: drop the payment uri round trip

kaladinlight
and
claude
committed
55a0d22
refactor: drop the isBip21Url comment

kaladinlight
and
claude
committed
5dca54e
refactor(utils): trim the buildPaymentUri docblock

kaladinlight
and
claude
committed
9a13e35
docs(swap-widget): name the two locks that disable redirects

kaladinlight
and
claude
committed
6d25be5
docs: move the public api contract out of the widget readme

kaladinlight
and
claude
committed
6b9f726
fix(swap-widget): don't use a bitcoin wallet address on doge, ltc or bch

kaladinlight
and
claude
committed
864bfed
fix(swap-widget): check the payload length on base58check addresses

kaladinlight
and
claude
committed
4fd24e0
fix(swap-widget): tighten witness program and starknet felt checks

kaladinlight
and
claude
committed
b8d1b6b
test(swap-widget): pin the restored deposit countdown

kaladinlight
and
claude
committed
6921b18
refactor(swap-widget): call the persisted address a refund address

kaladinlight
and
claude
committed
b0d7f2c
fix(swap-widget): never quote a sell-chain address as the receive address

kaladinlight
and
claude
committed
6e5a970
refactor(swap-widget): shorten the deposit polling comment

kaladinlight
and
claude
committed
491e34c
refactor(swap-widget): say why deposit polling outlives expiry

kaladinlight
and
claude
committed
e7d626d
fix(swap-widget): stop polling a deposit that never arrives

kaladinlight
and
claude
committed
79b5b73
refactor(swap-widget): reword the sendAddress context comment

kaladinlight
and
claude
committed
0df8b23
refactor(swap-widget): lift the swap callbacks out of status polling

kaladinlight
and
claude
committed
4f9153f
refactor(swap-widget): drop the floating pending deposit comment

kaladinlight
and
claude
committed
8edbc3d
refactor(swap-widget): correct the pending deposit guard comment

kaladinlight
and
claude
committed
ff1ef69
refactor(swap-widget): widen the restore ordering comment

kaladinlight
and
claude
committed
d3e9345
fix(swap-widget): validate TON addresses, and pin validator coverage

kaladinlight
and
claude
committed
c5f2ef3
refactor(swap-widget): correct the quoting effect's dep justification

kaladinlight
and
claude
committed
aab4eef
fix: address coderabbit review findings

kaladinlight
and
claude
committed
6769f9b
feat(utils): encode the amount in TON payment uris

kaladinlight
and
claude
committed
3151296
docs(swap-widget): keep the rollout note widget-facing

kaladinlight
and
claude
committed
b5fa975
docs(swap-widget): drop the rollout note again

kaladinlight
and
claude
committed
8c88ceb
fix(swap-widget): keep tracking a deposit across a reload

kaladinlight
and
claude
committed
96dc174
fix(swap-widget): accept a terminal status in both deposit states

kaladinlight
and
claude
committed
0d06c37
fix(swap-widget): bound tracking of a detected deposit too

kaladinlight
and
claude
committed
4559f26
fix(swap-widget): never leave a funded deposit spinning

kaladinlight
and
claude
committed
f01174a
refactor(public-api): name the store's retention distinctly

kaladinlight
and
claude
committed
6732bab
refactor(public-api): name the store's two deadlines

kaladinlight
and
claude
committed
c042783
test(public-api): name the fixture's quote window for what it is

kaladinlight
and
claude
committed
a374eb8
docs(public-api): trim the deposit and expiry field descriptions

kaladinlight
and
claude
committed
01e62bb
docs: match the deposit tracking behavior the widget now has

kaladinlight
and
claude
committed
dabb6e7
fix(swap-widget): call every reset a new swap

kaladinlight
and
claude
committed
9875e02
fix(swap-widget): time settlement tracking from the deposit, not the deadline

kaladinlight
and
claude
committed
6dac2b2
refactor(swap-widget): drop the receive address comment

kaladinlight
and
claude
committed
66be487
fix(swap-widget): report a deposit that completes with no hash

kaladinlight
and
claude
committed
18c9a91