Skip to main content

SuiLink

SuiLink enables securely linking wallet addresses from different blockchains to a Sui wallet address. Upon creating a SuiLink, you receive a soulbound NFT that serves as authenticated proof of ownership for your connected wallets.

Key features​

SuiLink provides the following capabilities:

  • Cross-chain identity verification: Link wallets from Ethereum, Solana, and other Sui addresses to your primary Sui wallet.
  • Non-transferable proof of ownership: Receive a soulbound NFT that cryptographically verifies wallet ownership.
  • Enhanced discoverability: Projects in the Sui ecosystem can discover you based on your activity across all connected wallets.
  • Reward eligibility: Unlock opportunities for cross-chain rewards, priority features, and exclusive events within the Sui network.

Supported networks​

SuiLink currently supports linking wallets cross-chain between Sui and Ethereum (Sui-to-Ethereum), and Sui and Solana (Sui-to-Solana).

Sui-to-Sui linking is currently only supported programmatically with a custom solution for the Playtron wallet app. For more information, visit the SuiPlay0X1 SuiLink integration guide.

Creating a SuiLink incurs a small gas fee on the Sui network to mint the soulbound NFT. Ensure you have some SUI tokens in your wallet to complete the connection.

To create a SuiLink:

  1. Visit https://www.suilink.io/
  2. Click Connect Sui Wallet
  3. Select the blockchain network you want to link: Ethereum or Solana
  4. Follow the prompts to authenticate and connect the wallet you want to link
  5. Complete the transaction to mint your SuiLink NFT

Each SuiLink connection creates a separate SuiLink NFT in your Sui wallet.

To view your linked addresses:

  1. View your SuiLink NFTs in your Sui wallet
  2. Check the network_address field to see which wallets are linked
  3. Review the timestamp to see when each link was created

You can permanently unlink a wallet by burning the corresponding NFT. To unlink an address:

  1. Navigate to the NFTs section of your Sui wallet
  2. For the SuiLink NFT you want to burn, select "Send" or "Transfer"
  3. Enter the burn address: 0x0000000000000000000000000000000000000000

Additionally, there are various third-party tools (such as SUI Manager) that can help burn NFTs, and some wallets have a built-in burning feature.

When building an application on Sui, you can integrate SuiLink to verify cross-chain ownership.

NetworkETH and SOL Package IDSui-to-Sui Package ID
Testnet0x0025bafa2e6afa511c19bd4e95626c897e798fde629b4782fe061bdc8bd65c8a0x0025bafa2e6afa511c19bd4e95626c897e798fde629b4782fe061bdc8bd65c8a
Mainnet0xf857fa9df5811e6df2a0240a1029d365db24b5026896776ddd1c3c70803bccd30x73f5ab2461c5993408fff21354fa9831d4f4a66cc81382419ec29e3c80c384b5

To retrieve a user's SuiLink connections, use the following gRPC query:

const SUILINK_PACKAGE_ID_ETH_SOL = '0xf857fa9df5811e6df2a0240a1029d365db24b5026896776ddd1c3c70803bccd3';
const SUILINK_PACKAGE_ID_SUI = '0x73f5ab2461c5993408fff21354fa9831d4f4a66cc81382419ec29e3c80c384b5';

const ethSolSuiLinks = await grpcClient.listOwnedObjects({
  owner: suiAddress,
  type: `${SUILINK_PACKAGE_ID_ETH_SOL}::suilink::SuiLink`,
  include: { json: true },
});

const suiSuiLinks = await grpcClient.listOwnedObjects({
  owner: suiAddress,
  type: `${SUILINK_PACKAGE_ID_SUI}::suilink::SuiLink`,
  include: { json: true },
});

This returns all SuiLink NFTs owned by the specified Sui address.

Each SuiLink NFT contains the following fields:

{
  "id": "0xcafe",
  "network_address": "0xdecaf",
  "timestamp_ms": "1751541273947"
}

The NFT type indicates which blockchain network the wallet is linked to:

for (const link of ethSolSuiLinks.objects) {
  const id = link.json.id as string;                   // "0xcafe"
  const linkedAddress = link.json.network_address as string; // "0xdecaf"
  const timestamp = link.json.timestamp_ms as string;        // "1751541273947"
  const chainType = link.type; // full type string includes the generic param,
                               // e.g. "...::SuiLink<...::ethereum::Ethereum>"
}

// Sui-to-Sui SuiLink (Mainnet)
0xf857fa9df5811e6df2a0240a1029d365db24b5026896776ddd1c3c70803bccd3::suilink::SuiLink<0x73f5ab2461c5993408fff21354fa9831d4f4a66cc81382419ec29e3c80c384b5::sui::Sui>

// Sui-to-Ethereum SuiLink (Testnet)
0x0025bafa2e6afa511c19bd4e95626c897e798fde629b4782fe061bdc8bd65c8a::suilink::SuiLink<0x0025bafa2e6afa511c19bd4e95626c897e798fde629b4782fe061bdc8bd65c8a::ethereum::Ethereum>

// Sui-to-Solana SuiLink (Testnet)
0x0025bafa2e6afa511c19bd4e95626c897e798fde629b4782fe061bdc8bd65c8a::suilink::SuiLink<0x0025bafa2e6afa511c19bd4e95626c897e798fde629b4782fe061bdc8bd65c8a::solana::Solana>

Verifying cross-chain asset ownership​

After retrieving a user's SuiLink objects, you can verify their ownership of specific assets on the linked blockchain:

  1. Extract the network_address from the SuiLink NFT.
  2. Use the appropriate blockchain APIs to query assets at that address, such as Alchemy for Ethereum, and Metaplex for Solana.
  3. Verify the presence of the required asset.
  4. Attribute benefits to the user through their Sui wallet.