Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
33 commits
Select commit Hold shift + click to select a range
c3c366d
bug fix - destination in the example is Scroll, not optimism
shaloo May 19, 2025
33fa887
Revert "Fix: #AR-9464 intent fixes"
shaloo Jun 2, 2025
6816e3d
Merge branch 'main' into shaloo/AR-9251-xcs-wallet
shaloo Jul 8, 2025
f0fca74
Fix: #AR-9227 xcs support baseline
shaloo Jul 8, 2025
55f8614
Merge branch 'main' into shaloo/AR-9227-xcs-sdk
shaloo Jul 9, 2025
d0a3cc1
fix vale errors
shaloo Jul 10, 2025
519ab76
Fix supported tokens for base CA
shaloo Jul 10, 2025
23f43f7
Update supported token list
shaloo Jul 10, 2025
d5917ca
tokens list update
shaloo Jul 15, 2025
07025a0
Merge branch 'main' into shaloo/AR-9227-xcs-sdk
shaloo Jul 15, 2025
98d641d
Merge branch 'main' into shaloo/AR-9227-xcs-sdk
shaloo Jul 16, 2025
c497413
Merge branch 'main' into shaloo/AR-9227-xcs-sdk
shaloo Jul 17, 2025
3dadc66
Merge branch 'main' into shaloo/AR-9227-xcs-sdk
shaloo Jul 17, 2025
e3d9cd8
Merge branch 'main' into shaloo/AR-9227-xcs-sdk
shaloo Jul 17, 2025
be10873
Merge branch 'main' into shaloo/AR-9227-xcs-sdk
shaloo Jul 18, 2025
2a21115
Merge branch 'main' into shaloo/AR-9227-xcs-sdk
shaloo Jul 23, 2025
fa68e6e
Merge branch 'main' into shaloo/AR-9251-xcs-wallet
shaloo Jul 23, 2025
bd01bc7
Update xcs token list - draft
shaloo Jul 23, 2025
d670bef
Merge branch 'shaloo/AR-9251-xcs-wallet' into shaloo/AR-9227-xcs-sdk
shaloo Jul 24, 2025
f39d810
vale fixes
shaloo Jul 24, 2025
ef1cfae
Merge branch 'shaloo/AR-9227-xcs-sdk' into shaloo/AR-9227-xcs
shaloo Jul 24, 2025
39ffc85
cleanup
shaloo Jul 24, 2025
f7d742d
combine edits across branches
shaloo Jul 24, 2025
dd90c6c
highlight example token
shaloo Jul 24, 2025
83922f2
Merge branch 'main' into shaloo/AR-9227-xcs
shaloo Jul 25, 2025
3352eda
Merge branch 'main' into shaloo/AR-9227-xcs
shaloo Jul 25, 2025
b5e1c25
Fix fuel note
shaloo Jul 25, 2025
42d33f3
Merge branch 'main' into shaloo/AR-9227-xcs
shaloo Jul 30, 2025
95b5b9b
Merge branch 'main' into shaloo/AR-9227-xcs
shaloo Jul 30, 2025
aa08893
Merge branch 'main' into shaloo/AR-9227-xcs
shaloo Jul 30, 2025
c338bf7
Fix: #AR-9608 social card bug fix in latest release enable and validate
shaloo Jul 31, 2025
661ea80
Merge branch 'main' into shaloo/AR-9227-xcs
shaloo Jul 31, 2025
97119bb
Merge branch 'main' into shaloo/AR-9227-xcs
shaloo Aug 1, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .github/styles/config/vocabularies/Arcana/accept.txt
Original file line number Diff line number Diff line change
Expand Up @@ -1006,6 +1006,7 @@ passwordless
Passwordless
PasswordlessOptions
Peaq
Pectra
performant
permissioned
Permissioned
Expand Down
4 changes: 4 additions & 0 deletions docs/concepts/ca/chain-abstraction.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,3 +9,7 @@ arcana:
# Chain Abstraction

{% include "./text-snippets/ca/what_is_ca.md" %}

## Cross-Chain Chain Abstraction (CCA)

{% include "./text-snippets/ca/cross_chain.md" %}
3 changes: 2 additions & 1 deletion docs/concepts/ca/unified-balance.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,4 +8,5 @@ arcana:

# Unified balance

{% include "./text-snippets/ca/unified_balance.md" %}
{% include "./text-snippets/ca/unified_balance.md" %}

11 changes: 11 additions & 0 deletions docs/concepts/ca/unified-xcs-balance.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
---
alias: concept-xcs
title: 'Unified Cross-Chain Swap Balance'
description: 'What does unified cross-chain swap balance mean in Arcana Chain Abstraction context?'
arcana:
root_rel_path: ..
---

# Cross-Chain Swap (XCS)

{% include "./text-snippets/ca/xcs_feature.md" %}
Binary file added docs/img/an_ca_xcs_feature.webp
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/quick-start/.ca-wagmi-quick-start.md.swp
Binary file not shown.
163 changes: 1 addition & 162 deletions docs/web3-stack/ca_stack.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,165 +18,4 @@ To execute a chain-abstracted transaction, you need enough unified balance of th

{% include "./text-snippets/ca_token_qualifier.md" %}

### Ethereum

=== "Mainnet"

| Tokens | Coral |
| :--- | :---|
| ETH | ✅ |
| USDC | ✅ |
| USDT | ✅ |

=== "Sepolia"

| Tokens | Folly |
| :--- | :---|
| ETH | ✅ |
| USDC | ✅ |

### Optimism

=== "Mainnet"

| Tokens | Coral |
| :--- | :--- |
| ETH | ✅ |
| USDC | ✅ |
| USDT | ✅ |

=== "OP Sepolia"

| Tokens | Folly |
| :--- | :--- |
| ETH | ✅ |
| USDC | ✅ |
| USDT | ✅ |

### BSC

=== "Mainnet"

| Tokens | Coral |
| :--- | :--- |
| ETH | ✅ |
| USDC | ✅ |
| USDT | ✅ |
| BNB | ✅ |

### Polygon

=== "Mainnet"

| Tokens | Coral
| :--- | :--- |
| USDC | ✅ |
| USDT | ✅ |
| POL | ✅ |

=== "Polygon Amoy"

| Tokens | Folly |
| :--- | :--- |
| USDC | ✅ |
| POL | ✅ |


<!--- Commenting out HyperEVM July 21 casdk update

### HyperEVM

=== "Mainnet"

| Tokens | Coral |
| :--- | :--- |
| USDT | ✅ |
| HYPE | ✅ |
-->

### Kaia

=== "Mainnet"

| Tokens | Coral |
| :--- | :--- |
| USDT | ✅ |
| KAIA | ✅ |

### Base

=== "Mainnet"

| Tokens | Coral |
| :--- | :--- |
| ETH | ✅ |
| USDC | ✅ |
| USDT | ✅ |

=== "Base Sepolia"

| Tokens | Folly |
| :--- | :--- |
| ETH | ✅ |
| USDC | ✅ |

### Fuel

=== "Mainnet"

| Tokens | Coral |
| :--- | :--- |
| ETH | ✅ |
| USDC | ✅ |
| USDT | ✅ |

{% include "./text-snippets/warn_no_fuel_support_ca_wagmi.md" %}

### Arbitrum

=== "Mainnet"

| Tokens | Coral |
| :--- | :--- |
| ETH | ✅ |
| USDC | ✅ |
| USDT | ✅ |

=== "Arbitrum Sepolia"

| Tokens | Folly |
| :--- | :---|
| ETH | ✅ |
| USDC | ✅ |
| USDT | ✅ |

### Avalanche

=== "Mainnet"

| Tokens | Coral |
| :--- | :--- |
| USDC | ✅ |
| USDT | ✅ |
| AVAX | ✅ |

### Sophon

=== "Mainnet"

| Tokens | Coral |
| :--- | :--- |
| ETH | ✅ |
| USDC | ✅ |
| USDT | ✅ |
| SOPH | ✅ |

### Scroll

=== "Mainnet"

| Tokens | Coral |
| :--- | :--- |
| ETH | ✅ |
| USDC | ✅ |
| USDT | ✅ |
{% include "./text-snippets/ca/generated_chainlist.md" %}
161 changes: 1 addition & 160 deletions docs/web3-stack/ca_wallet_stack.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,163 +24,4 @@ To try unified balance and chain abstracted transactions, connect the [standalon

{% include "./text-snippets/ca_token_qualifier.md" %}

### Ethereum

=== "Mainnet"

| Tokens | Coral |
| :--- | :---|
| ETH | ✅ |
| USDC | ✅ |
| USDT | ✅ |

=== "Sepolia"

| Tokens | Folly |
| :--- | :---|
| ETH | ✅ |
| USDC | ✅ |

### Optimism

=== "Mainnet"

| Tokens | Coral |
| :--- | :--- |
| ETH | ✅ |
| USDC | ✅ |
| USDT | ✅ |

=== "OP Sepolia"

| Tokens | Folly |
| :--- | :--- |
| ETH | ✅ |
| USDC | ✅ |
| USDT | ✅ |

### BSC

=== "Mainnet"

| Tokens | Coral |
| :--- | :--- |
| ETH | ✅ |
| USDC | ✅ |
| USDT | ✅ |
| BNB | ✅ |

### Polygon

=== "Mainnet"

| Tokens | Coral
| :--- | :--- |
| USDC | ✅ |
| USDT | ✅ |
| POL | ✅ |

=== "Polygon Amoy"

| Tokens | Folly |
| :--- | :--- |
| USDC | ✅ |
| POL | ✅ |


<!--- Commenting out HyperEVM July 21 casdk update

### HyperEVM

=== "Mainnet"

| Tokens | Coral |
| :--- | :--- |
| USDT | ✅ |
| HYPE | ✅ |
-->

### Kaia

=== "Mainnet"

| Tokens | Coral |
| :--- | :--- |
| USDT | ✅ |
| KAIA | ✅ |

### Base

=== "Mainnet"

| Tokens | Coral |
| :--- | :--- |
| ETH | ✅ |
| USDC | ✅ |
| USDT | ✅ |

=== "Base Sepolia"

| Tokens | Folly |
| :--- | :--- |
| ETH | ✅ |
| USDC | ✅ |

### Fuel

=== "Mainnet"

| Tokens | Coral |
| :--- | :--- |
| ETH | ✅ |
| USDC | ✅ |
| USDT | ✅ |

### Arbitrum

=== "Mainnet"

| Tokens | Coral |
| :--- | :--- |
| ETH | ✅ |
| USDC | ✅ |
| USDT | ✅ |

=== "Arbitrum Sepolia"

| Tokens | Folly |
| :--- | :---|
| ETH | ✅ |
| USDC | ✅ |
| USDT | ✅ |

### Avalanche

=== "Mainnet"

| Tokens | Coral |
| :--- | :--- |
| USDC | ✅ |
| USDT | ✅ |
| AVAX | ✅ |

### Sophon

=== "Mainnet"

| Tokens | Coral |
| :--- | :--- |
| ETH | ✅ |
| USDC | ✅ |
| USDT | ✅ |
| SOPH | ✅ |

### Scroll

=== "Mainnet"

| Tokens | Coral |
| :--- | :--- |
| ETH | ✅ |
| USDC | ✅ |
| USDT | ✅ |
{% include "./text-snippets/ca/generated_chainlist.md" %}
21 changes: 21 additions & 0 deletions includes/text-snippets/ca/cross_chain.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
[[concept-ca|Chain abstraction]] lets users spend *a single token type (like USDT)* across source chains using a [[concept-unified-balance|unified balance]]. They can then use that balance on any destination chain—still as USDT.

Cross-chain Chain Abstraction (CCA) takes it further. Users can now *combine multiple token types (like USDT, USDC)* into one unified balance across chains—and spend it as any supported token (USDT, USDC, etc.) on any destination chain.

The cross-chain chain abstraction is atomic in nature. It involves multiple source chains and token types and batches transactions. If any one sub-transaction fails, the entire cross-chain transaction fails.

Cross-chain CA transactions do not have any overheads as compared to the basic chain abstracted transactions. These may be marginally faster than the basic chain abstracted transactions (single token type).

??? an-note "Pectra Support"

By default, Cross-Chain Abstraction (CCA) kicks in automatically for transactions between source chains that support Pectra.

If any source chain doesn’t support Pectra, the SDK falls back to basic chain abstraction. This means users can use unified token balance to spend only a single unified token type from the source chains.

The SDK smartly picks between CCA and base chain abstraction based on the source chains in the transaction and their Pectra support. No extra setup is needed by Web3 apps or users.

??? an-tip "About Refunds"

If a cross-chain CA transaction fails, the user gets a refund equal to the total deposits collected from their EOA across all source chains.

Even if the deposits involved multiple token types, the refund is always in USDC.
Loading