Skip to content

Commit f7d742d

Browse files
shalooshaloo
committed
combine edits across branches
1 parent 39ffc85 commit f7d742d

File tree

7 files changed

+57
-54
lines changed

7 files changed

+57
-54
lines changed

‎docs/concepts/ca/unified-xcs-balance.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,6 @@ arcana:
66
root_rel_path: ..
77
---
88

9-
# Unified Cross-Chain Swap
9+
# Cross-Chain Swap (XCS)
1010

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

‎docs/img/an_ca_xcs_feature.webp

-61.1 KB
Binary file not shown.

‎docs/web3-stack/ca_stack.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,6 @@ arcana:
1111
The {{config.extra.arcana.ca_sdk_name}} supports [[concept-unified-balance|unified balance]] and [[concept-ca|chain-abstracted transactions]] for the chains and tokens^*^ listed below.
1212

1313
To execute a chain-abstracted transaction, you need enough unified balance of the token type on the source chain. This balance must cover both the gas fee and the transaction amount on the destination chain.
14-
>>>>>>> main
1514

1615
^*^ *Every chain may not support all tokens. The list of supported chains and tokens may differ for the Coral and the Folly testnet. The chains supported by the SDK and those supported in the standalone, CA wallet used in the demos may not always be the same.*
1716

‎includes/text-snippets/ca/generated_chainlist.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
!!! an-note "Unified Balance (XCS)"
22

3-
Cross-Chain Support (XCS) enhances unified balance by allowing users to spend any supported token (e.g., USDT, USDC) from any source chain on any destination chain—provided the chain and token contract support the EIP-2612 `permit` function.
3+
[[concept-xcs|Cross-Chain Support (XCS)]] enhances unified balance by allowing users to spend any supported token (e.g., USDT, USDC) from any source chain on any destination chain—provided the chain and token contract support the EIP-2612 `permit` function.
44

5-
For chains or tokens without `permit/EIP-2612`, the protocol reverts to the older unified balance, which only combines the same token type across source chains.
5+
For chains or tokens without `permit/EIP-2612`, the protocol reverts to the basic unified balance, which only combines the same token type across source chains.
66

77
### Ethereum
88

‎includes/text-snippets/ca/unified_balance.md

Lines changed: 32 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,42 @@
1-
Unified balance shows the total liquidity in a user's EOA account across multiple chains and tokens.
1+
Unified balance shows the total liquidity in a user's EOA account. It
2+
combines the token balance across multiple chains. This lets users spend
3+
the available liquidity on any destination chain via chain
4+
abstracted transactions.
25

3-
Chain abstraction lets users spend available liquidity on any destination chain. No bridges or pre-provisioned gas are needed. All cross-chain complexity is handled behind the scenes. Users approve just once for a seamless experience.
6+
No bridges or pre-provisioned gas are needed. All cross-chain complexity is handled behind the scenes. Users approve their intent to spend just once for a seamless experience.
47

5-
**Unified Balance Levels**
8+
!!! an-example "Example"
69

7-
Balance unification works at two levels, depending on chain and token support:
8-
- **Baseline Chain Cbstraction (CA):** Combines a single token type from source chains. Users spend the unified balance of that token on any destination chain.
9-
- **Cross-Chain Swap (XCS):** Combines multiple token types from source chains. Users spend as any token on any destination chain. This advanced feature requires chains and tokens to support `permit/EIP-2612`.
10+
Consider a wallet balance:
11+
12+
- *Optimism:* 0.1 ETH, 0 USDT, 0 USDC
13+
- *Arbitrum:* 0 ETH, 12 USDT, 0 USDC
14+
- *Base:* 0 ETH, 10 USDT, 0 USDC
15+
- *Scroll:* 0 ETH, 0 USDT, 0 USDC
1016

11-
!!! an-example "Example"
17+
With no unified balance or chain abstraction, user *cannot spend any USDT on Scroll* unless
18+
they use a bridge to convert tokens.
19+
20+
With basic unified balance and chain abstracted transaction, user **can spend 18 USDT on Scroll**.
1221

13-
| CA | XCS |
14-
|:---|:---|
15-
| User wants to spend **18 USDT** on *Scroll*.| User wants to spend **18 USDC** on *Scroll*.|
16-
| The wallet balance is:| The wallet balance is:|
17-
| | |
18-
| *Optimism:* 0.1 ETH, 0 USDT, 0 USDC | *Optimism:* 0.1 ETH, 0 USDT, 0 USDC |
19-
| *Arbitrum:* 0 ETH, 12 USDT, 0 USDC | *Arbitrum:* 0 ETH, 12 USDT, 0 USDC |
20-
| *Base:* 0 ETH, 10 USDT, 0 USDC | *Base:* 0 ETH, 10 USDT, 0 USDC |
21-
| *Scroll:* 0 ETH, 0 USDT, 0 USDC | *Scroll:* 0 ETH, 0 USDT, 0 USDC |
22-
| | |
23-
| CA allows user to use unified USDT balance on Arbitrum | XCS allows user to use unified USDT balance and
24-
| and Base and spend 18 USDT on Scroll. | spend it as USDC on Scroll. |
25-
26-
Both types let users spend assets on any chain, even without prior liquidity on the destination chain. Cross-chain swap also allows combining multiple supported assets across chains, solving liquidity fragmentation.
22+
| Intent | No Unified Balance / CA | Unified Balance |
23+
|:---|:---|:---|
24+
| Spend 18 **USDT** on Scroll | ❌ | ✅ |
2725

2826
<figure markdown="span">
2927
<img alt="With CA" src="{{config.extra.arcana.img_dir}}/ca_unified_balance.{{config.extra.arcana.img_png}}"/>
30-
<figcaption>Single chain liquidity vs. Unified Balance with Chain Abstraction</figcaption>
28+
<figcaption>Basic Unified Balance with Chain Abstraction</figcaption>
3129
</figure>
3230

31+
**Cross Chain Swap (XCS)**
32+
33+
Balance unification works at two levels, depending upon whether single token type is combined from source chains or can multiple token types be combined from source chains. The capability is subject to whether the chain and tokens supports `permit/EIP-2612':
34+
35+
* Unified Balance (Basic)
36+
* Unified Balance with Cross-Chain Swap (XCS)
37+
38+
{% include "./text-snippets/ca/xcs_feature.md" %}
39+
40+
41+
42+

‎includes/text-snippets/ca/xcs_feature.md

Lines changed: 21 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
The Arcana chain abstraction protocol has evolved to a cross-chain swap
22
enabled unified balance.
33

4-
**Unified Balance**
4+
**Basic Unified Balance**
55

66
- Users could combine the same token type (for example, USDT) held across
77
multiple source chains into a single, unified balance.
@@ -11,23 +11,7 @@ enabled unified balance.
1111
chains combined, or had no liquidity on the destination chain, they
1212
could not complete the transaction.
1313

14-
??? an-example "Example"
15-
16-
User wallet balance:
17-
0 USDT on Scroll,
18-
0.25 USDC and 0.5 USDT on Arbitrum
19-
0.75 USDT on Base
20-
21-
To spend 0.8 USDT on Scroll is not possible considering balance
22-
on Scroll.
23-
24-
Unified balance (Arbitrum + Base) allows the chain
25-
abstracted transaction, but only with USDT.
26-
27-
User cannot make a larger transaction, say 1.0 USDT and also
28-
utilize the 0.25 USDC available on Arbitrum.
29-
30-
**Unified Balance + XCS**
14+
**Unified Balance with Cross-Chain Swap (XCS)**
3115

3216
- The new improved unified balance approach allows cross-chain swaps.
3317
- Users can now spend any supported token (for example, USDT, USDC) from
@@ -37,19 +21,29 @@ enabled unified balance.
3721
sufficient balance in a single token or on the destination chain.
3822
- This significantly increases the available liquidity and flexibility,
3923
enabling larger transactions and covers gas fee.
24+
- This advanced feature requires chains and tokens to support `permit/EIP-2612`.
25+
- The chain abstraction protocol falls back to the basic unified balance if the chains
26+
and tokens do not support `permit/EIP-2612`.
27+
28+
!!! an-example "Example"
4029

41-
??? an-example "Example"
30+
Consider a wallet balance:
31+
32+
- *Optimism:* 0.1 ETH, 0 USDT, 0 USDC
33+
- *Arbitrum:* 0 ETH, 12 USDT, 0 USDC
34+
- *Base:* 0 ETH, 10 USDT, 0 USDC
35+
- *Scroll:* 0 ETH, 0 USDT, 0 USDC
4236

43-
User wallet balance:
44-
0 USDT on Scroll,
45-
0.25 USDC and 0.5 USDT on Arbitrum
46-
0.75 USDT on Base
37+
With no unified balance or chain abstraction, user cannot spend any USDT on Scroll unless
38+
they use a bridge to convert tokens.
4739

48-
To spend 1.0 USDT on Scroll is not possible considering balance
49-
on Scroll.
40+
With basic unified balance and chain abstracted transaction, user can spend 18 USDT on Scroll.
41+
XCS feature lets user spend 18 USDC on Scroll which is not possible with basic unified balance.
5042

51-
Unified balance (Arbitrum + Base, USDT+USDC) allows the chain
52-
abstracted transaction.
43+
| Intent | No Unified Balance / CA | Unified Balance | Unified Balance + XCS |
44+
|:---|:---|:---|:--- |
45+
| Spend 18 **USDT** on Scroll | ❌ | ✅ | ✅ |
46+
| Spend 18 **USDC** on Scroll | ❌ | ❌ | ✅ |
5347

5448
<figure markdown="span">
5549
![Intent Explorer]({{config.extra.arcana.img_dir}}/an_ca_xcs_feature.{{config.extra.arcana.img_png}}){ .an-screenshots }

‎mkdocs.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -551,7 +551,7 @@ nav:
551551
- Concepts:
552552
- Chain Abstraction: concepts/ca/chain-abstraction.md
553553
- Unified Balance: concepts/ca/unified-balance.md
554-
- Unified Cross-Chain Swap Balance: concepts/ca/unified-xcs-balance.md
554+
- Cross-Chain Swap (XCS): concepts/ca/unified-xcs-balance.md
555555
- Allowances: concepts/ca/allowances.md
556556
- Intent: concepts/ca/intent.md
557557
- Intent Explorer: concepts/ca/intent-explorer.md

0 commit comments

Comments
 (0)