Skip to content

add Sui support to the cross chain docs #386

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
0xmaayan merged 4 commits into from
Mar 2, 2026
Merged

add Sui support to the cross chain docs #386

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
19261a3
add Sui support to the cross chain docs
0xmaayan Feb 17, 2026
4f0acc7
address comments
0xmaayan Mar 2, 2026
2affa54
correct nano-staged remark command to process only staged files
0xmaayan Mar 2, 2026
a62a572
address comments
0xmaayan Mar 2, 2026
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
2 changes: 1 addition & 1 deletion package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -155,7 +155,7 @@
"prettier --write"
],
"src/content/**/*.mdx": [
"remark \"src/content/**/*.{md,mdx}\" --output"
"remark --output --"
Copy link
Contributor Author

@0xmaayan 0xmaayan Mar 2, 2026 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The previous nano-staged command remark "src/content/**/*.{md,mdx}" --output had two issues:

  1. It hardcoded a glob that processed all content files on every commit, not just the staged ones.
  2. When nano-staged appended the staged file path, remark interpreted it as the destination for --output, causing "Cannot write multiple files to single output" errors.

Changed to remark --output -- so that nano-staged passes only the staged files as input, and -- prevents remark from consuming the file path as the output destination.

]
}
}
74 changes: 67 additions & 7 deletions src/content/docs/build/sdks/wallet-adapter/x-chain-accounts.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,8 +38,6 @@ The computation of the DAA address is done using the `authenticationFunction` an

### How to integrate x-chain accounts in my dApp?

Currently, the adapter supports Solana and EVM chains

<Aside type="note">
It is highly recommended to use the `@aptos-labs/wallet-adapter-react` package for the best experience. Make sure you integrate with the Aptos Wallet Adapter by following these [steps](/build/sdks/wallet-adapter/dapp)
</Aside>
Expand Down Expand Up @@ -89,10 +87,10 @@ Currently, the adapter supports Solana and EVM chains
}}
>
{children}
<AptosWalletAdapterProvider/>
</AptosWalletAdapterProvider>
```

3. Set crossChainWallets dapp config prop to true fot the AptosWalletAdapterProvider
3. Set crossChainWallets dapp config prop to true for the AptosWalletAdapterProvider

```tsx filename="WalletProvider.tsx"
<AptosWalletAdapterProvider
Expand All @@ -102,7 +100,7 @@ Currently, the adapter supports Solana and EVM chains
}}
>
{children}
<AptosWalletAdapterProvider/>
</AptosWalletAdapterProvider>
```
</Steps>
</TabItem>
Expand Down Expand Up @@ -149,7 +147,69 @@ Currently, the adapter supports Solana and EVM chains
}}
>
{children}
<AptosWalletAdapterProvider/>
</AptosWalletAdapterProvider>
```

3. Set crossChainWallets dapp config prop to true fot the AptosWalletAdapterProvider

```tsx filename="WalletProvider.tsx"
<AptosWalletAdapterProvider
dappConfig={{
network: Network.TESTNET,
crossChainWallets: true,
}}
>
{children}
</AptosWalletAdapterProvider>
```
</Steps>
</TabItem>

{/* Sui */}

<TabItem label="Sui">
The wallet adapter follows the [Sui Wallet Standard](https://docs.sui.io/standards/wallet-standard) to discover wallets.
Currently, the wallets that have been tested and support cross-chain accounts are:

| | Aptos Devnet | Aptos Testnet | Aptos Mainnet |
| ------------ | ------------ | ------------- | ------------- |
| Backpack | ✅ | ✅ | ✅ |
| Bitget | ✅ | ✅ | ✅ |
| Ethos | ✅ | ✅ | ✅ |
| Nightly | ✅ | ✅ | ✅ |
| OKX | ✅ | ✅ | ✅ |
| Phantom | ✅ | ✅ | ✅ |
| Slush | ✅ | ✅ | ✅ |
| Trust Wallet | ✅ | ✅ | ✅ |

Supporting x-chain accounts in a dApp requires only a 2-step installation process.

<Steps>
1. Install the @aptos-labs/derived-wallet-sui package

```shellscript
npm install @aptos-labs/derived-wallet-sui
```

2. Import the setupAutomaticSuiWalletDerivation function

Once you have installed the `@aptos-labs/derived-wallet-sui` package, you can import and use it.
In the same file where you import the other wallets, such as `WalletProvider.tsx`, you can add the following:

```tsx filename="WalletProvider.tsx"
import { setupAutomaticSuiWalletDerivation } from "@aptos-labs/derived-wallet-sui";

setupAutomaticSuiWalletDerivation({ defaultNetwork: Network.TESTNET }); // this is the Aptos network your dapp is working with

...

<AptosWalletAdapterProvider
dappConfig={{
network: Network.TESTNET,
}}
>
{children}
</AptosWalletAdapterProvider>
```

3. Set crossChainWallets dapp config prop to true fot the AptosWalletAdapterProvider
Expand All @@ -162,7 +222,7 @@ Currently, the adapter supports Solana and EVM chains
}}
>
{children}
<AptosWalletAdapterProvider/>
</AptosWalletAdapterProvider>
```
</Steps>
</TabItem>
Expand Down
10 changes: 4 additions & 6 deletions src/content/docs/es/build/sdks/wallet-adapter/x-chain-accounts.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -39,8 +39,6 @@ El cálculo de la dirección DAA se hace usando la `authenticationFunction` y la

### ¿Cómo integrar cuentas x-chain en mi dApp?

Actualmente, el adaptador soporta cadenas Solana y EVM

<Aside type="note">
Se recomienda altamente usar el paquete `@aptos-labs/wallet-adapter-react` para la mejor experiencia. Asegúrate de integrar con el Adaptador de Wallet de Aptos siguiendo estos [pasos](/es/build/sdks/wallet-adapter/dapp)
</Aside>
Expand Down Expand Up @@ -86,7 +84,7 @@ Actualmente, el adaptador soporta cadenas Solana y EVM
}}
>
{children}
<AptosWalletAdapterProvider/>
</AptosWalletAdapterProvider>
```

3. Establecer la prop crossChainWallets dapp config a true para el AptosWalletAdapterProvider
Expand All @@ -99,7 +97,7 @@ Actualmente, el adaptador soporta cadenas Solana y EVM
}}
>
{children}
<AptosWalletAdapterProvider/>
</AptosWalletAdapterProvider>
```
</Steps>
</TabItem>
Expand Down Expand Up @@ -146,7 +144,7 @@ Actualmente, el adaptador soporta cadenas Solana y EVM
}}
>
{children}
<AptosWalletAdapterProvider/>
</AptosWalletAdapterProvider>
```

3. Set crossChainWallets dapp config prop to true fot the AptosWalletAdapterProvider
Expand All @@ -159,7 +157,7 @@ Actualmente, el adaptador soporta cadenas Solana y EVM
}}
>
{children}
<AptosWalletAdapterProvider/>
</AptosWalletAdapterProvider>
```
</Steps>
</TabItem>
Expand Down