@interest-protocol/xbridge-sdk 1.0.0

package/README.md

@@ -0,0 +1,110 @@
+# @lattice/xbridge-sdk
+
+SDK for cross-chain token bridge (inbound and outbound).
+
+## Installation
+
+```bash
+bun install
+```
+
+## Architecture
+
+XBridge uses two separate contracts:
+
+| Class | Direction | Description |
+|-------|-----------|-------------|
+| `XBridgeInbound` | Foreign → Sui | Mint wrapped tokens on Sui |
+| `XBridgeOutbound` | Sui → Foreign | Lock native tokens on Sui |
+
+## Usage
+
+### Inbound (Foreign → Sui)
+
+```typescript
+import { XBridgeInbound, ChainId } from '@lattice/xbridge-sdk';
+
+const inbound = new XBridgeInbound({
+    suiClient,
+    packageId: INBOUND_PACKAGE_ID,
+    xbridgeInboundSharedObjectData,
+    xcoreSharedObjectData,
+});
+
+// Create mint request
+const tx = inbound.newMintRequest({
+    sourceChain: ChainId.Solana,
+    digest,
+    amount: 1000000n,
+    fee,
+    coinType: '0x...::wsol::WSOL',
+});
+
+// Vote on mint request (validator)
+const tx = inbound.voteMintRequest({
+    requestId,
+    voteProof,
+    coinType,
+});
+```
+
+### Outbound (Sui → Foreign)
+
+```typescript
+import { XBridgeOutbound, ChainId } from '@lattice/xbridge-sdk';
+
+const outbound = new XBridgeOutbound({
+    suiClient,
+    packageId: OUTBOUND_PACKAGE_ID,
+    xbridgeOutboundSharedObjectData,
+    xcoreSharedObjectData,
+});
+
+// Create lock request
+const tx = outbound.newLockRequest({
+    targetChain: ChainId.Solana,
+    recipient,
+    amount: 1000000n,
+    coin,
+    fee,
+    coinType: '0x2::sui::SUI',
+});
+
+// Vote on lock request (validator)
+const tx = outbound.voteLockRequest({
+    requestId,
+    voteProof,
+    coinType,
+});
+```
+
+## Wallet Keys
+
+**IMPORTANT**: XBridge uses different wallet keys than XSwap.
+
+| Chain | Wallet Key |
+|-------|------------|
+| Solana | 2 |
+| Sui | 3 |
+
+## Enclave Intents
+
+| Intent | Value | Use Case |
+|--------|-------|----------|
+| Vote | 2 | Vote on mint/burn requests |
+| Cancel | 3 | Cancel mint request |
+| VoteLock | 6 | Vote on lock requests |
+| VoteUnlock | 7 | Vote on unlock requests |
+| CancelUnlock | 8 | Cancel unlock request |
+
+## Development
+
+```bash
+bun run build    # Build package
+bun run test     # Run tests
+bun run lint     # Run linter
+```
+
+## Documentation
+
+See [../CLAUDE.md](../CLAUDE.md) for SDK architecture patterns.

package/dist/constants.d.ts

@@ -0,0 +1,171 @@
+import type { WalletConfig } from './xbridge.types';
+export declare const ORIGINAL_PACKAGE_ID = "0xb39fe0c60c140063923a723f4e0e5bc008d1593ae3c6a71aa89fed5dc3546c15";
+export declare const MAINNET_PACKAGE_ID = "0xb39fe0c60c140063923a723f4e0e5bc008d1593ae3c6a71aa89fed5dc3546c15";
+export declare const XBRIDGE_CONFIG_OBJECT_ID = "0x57c21dcb22f860504b160b5abf523b43c20398d9a7c675b46ba558bd530c79ee";
+export declare const XBRIDGE_CONFIG_INITIAL_SHARED_VERSION = "782601350";
+export declare const XBRIDGE_CONFIG_SHARED_OBJECT_DATA: {
+    readonly objectId: "0x57c21dcb22f860504b160b5abf523b43c20398d9a7c675b46ba558bd530c79ee";
+    readonly initialSharedVersion: "782601350";
+};
+export declare const XBRIDGE_INBOUND_OBJECT_ID = "0x4edfb48ff61c6722722d00949125b10ff3df263492339546ae75b94a276cb746";
+export declare const XBRIDGE_INBOUND_INITIAL_SHARED_VERSION = "782601350";
+export declare const XBRIDGE_INBOUND_SHARED_OBJECT_DATA: {
+    readonly objectId: "0x4edfb48ff61c6722722d00949125b10ff3df263492339546ae75b94a276cb746";
+    readonly initialSharedVersion: "782601350";
+};
+export declare const XBRIDGE_OUTBOUND_OBJECT_ID = "0xc7b3eec085c1920a0da6d4907883454c43e45facdbce614599d5722b70ba45dd";
+export declare const XBRIDGE_OUTBOUND_INITIAL_SHARED_VERSION = "782601350";
+export declare const XBRIDGE_OUTBOUND_SHARED_OBJECT_DATA: {
+    readonly objectId: "0xc7b3eec085c1920a0da6d4907883454c43e45facdbce614599d5722b70ba45dd";
+    readonly initialSharedVersion: "782601350";
+};
+export declare const ADMIN_CAP_OBJECT_ID = "0x2e29bc107f05fc340b124e8c4b174a7c661df5aea9dd98e546fcb27742608b61";
+export declare const UPGRADE_CAP_OBJECT_ID = "0xe200edca09e4bd0c55ae3c3c65f52a5619ad5376292a966f62dcb72def60883b";
+export declare const DWALLET_COORDINATOR_OBJECT_ID = "0x5ea59bce034008a006425df777da925633ef384ce25761657ea89e2a08ec75f3";
+export declare const DWALLET_COORDINATOR_INITIAL_SHARED_VERSION = "595876492";
+export declare const DWALLET_COORDINATOR_SHARED_OBJECT_DATA: {
+    readonly objectId: "0x5ea59bce034008a006425df777da925633ef384ce25761657ea89e2a08ec75f3";
+    readonly initialSharedVersion: "595876492";
+};
+export declare const ConfigModule: "config";
+export declare const InboundModules: {
+    readonly Inbound: "inbound";
+    readonly Structs: "structs";
+    readonly Auth: "auth";
+};
+export declare const OutboundModules: {
+    readonly Outbound: "outbound";
+    readonly Structs: "structs";
+    readonly Auth: "auth";
+};
+export declare const ChainTokenModule: "chain_token";
+export declare const ChainTokenFunctions: {
+    readonly NewSolana: "new_solana";
+    readonly NewEvm: "new_evm";
+    readonly NewSui: "new_sui";
+};
+export declare const ChainExecuteDataModule: "chain_execute_data";
+export declare const ChainExecuteDataFunctions: {
+    readonly NewSolana: "new_solana";
+    readonly NewEvm: "new_evm";
+    readonly NewSui: "new_sui";
+};
+export declare const ConfigFunctions: {
+    readonly InitApp: "init_app";
+    readonly MintPresign: "mint_presign";
+    readonly AddWallet: "add_wallet";
+    readonly AddValidator: "add_validator";
+    readonly RemoveValidator: "remove_validator";
+    readonly SetMinVotes: "set_min_votes";
+    readonly SetMintFee: "set_mint_fee";
+    readonly SetBurnFee: "set_burn_fee";
+    readonly SetLockFee: "set_lock_fee";
+    readonly SetUnlockFee: "set_unlock_fee";
+    readonly SetPresignFee: "set_presign_fee";
+    readonly SetExpectedPcrs: "set_expected_pcrs";
+    readonly CollectFees: "collect_fees";
+    readonly Pause: "pause";
+    readonly Unpause: "unpause";
+    readonly AddWatchtower: "add_watchtower";
+    readonly RemoveWatchtower: "remove_watchtower";
+};
+export declare const InboundFunctions: {
+    readonly InitApp: "init_app";
+    readonly NewMintRequest: "new_mint_request";
+    readonly SetMintDigest: "set_mint_digest";
+    readonly VoteMintRequest: "vote_mint_request";
+    readonly ExecuteMintRequest: "execute_mint_request";
+    readonly CancelMintRequest: "cancel_mint_request";
+    readonly NewBurnRequest: "new_burn_request";
+    readonly VoteBurnRequest: "vote_burn_request";
+    readonly ExecuteBurnRequest: "execute_burn_request";
+    readonly CancelBurnRequest: "cancel_burn_request";
+    readonly MintPresign: "mint_presign";
+    readonly AddToken: "add_token";
+    readonly AddWallet: "add_wallet";
+    readonly AddChain: "add_chain";
+    readonly RemoveChain: "remove_chain";
+    readonly AddValidator: "add_validator";
+    readonly RemoveValidator: "remove_validator";
+    readonly SetMintFee: "set_mint_fee";
+    readonly SetBurnFee: "set_burn_fee";
+    readonly SetPresignFee: "set_presign_fee";
+    readonly SetExpectedPcrs: "set_expected_pcrs";
+    readonly SetMinVotes: "set_min_votes";
+    readonly SetMaxSupply: "set_max_supply";
+    readonly SetRateLimit: "set_rate_limit";
+    readonly CollectFees: "collect_fees";
+    readonly Pause: "pause";
+    readonly Unpause: "unpause";
+    readonly DigestConsumed: "digest_consumed";
+    readonly TotalSupply: "total_supply";
+    readonly AvailableMintSupply: "available_mint_supply";
+};
+export declare const OutboundFunctions: {
+    readonly InitApp: "init_app";
+    readonly NewLockRequest: "new_lock_request";
+    readonly VoteLockRequest: "vote_lock_request";
+    readonly ExecuteLockRequest: "execute_lock_request";
+    readonly CancelLockRequest: "cancel_lock_request";
+    readonly NewUnlockRequest: "new_unlock_request";
+    readonly SetUnlockDigest: "set_unlock_digest";
+    readonly VoteUnlockRequest: "vote_unlock_request";
+    readonly ExecuteUnlockRequest: "execute_unlock_request";
+    readonly CancelUnlockRequest: "cancel_unlock_request";
+    readonly MintPresign: "mint_presign";
+    readonly RegisterToken: "register_token";
+    readonly SetMaxLock: "set_max_lock";
+    readonly AddWallet: "add_wallet";
+    readonly AddChain: "add_chain";
+    readonly RemoveChain: "remove_chain";
+    readonly AddValidator: "add_validator";
+    readonly RemoveValidator: "remove_validator";
+    readonly SetLockFee: "set_lock_fee";
+    readonly SetUnlockFee: "set_unlock_fee";
+    readonly SetPresignFee: "set_presign_fee";
+    readonly SetExpectedPcrs: "set_expected_pcrs";
+    readonly SetMinVotes: "set_min_votes";
+    readonly SetRateLimit: "set_rate_limit";
+    readonly CollectFees: "collect_fees";
+    readonly Pause: "pause";
+    readonly Unpause: "unpause";
+    readonly DigestConsumed: "digest_consumed";
+    readonly LockedBalance: "locked_balance";
+};
+export declare const ChainId: {
+    readonly Solana: 1;
+    readonly Evm: 2;
+    readonly Sui: 3;
+};
+export type ChainId = (typeof ChainId)[keyof typeof ChainId];
+export declare const Intent: {
+    readonly Vote: 2;
+    readonly Cancel: 3;
+    readonly VoteLock: 6;
+    readonly VoteUnlock: 7;
+    readonly CancelUnlock: 8;
+};
+export type Intent = (typeof Intent)[keyof typeof Intent];
+export declare const RequestStatus: {
+    readonly Pending: 0;
+    readonly Completed: 1;
+    readonly Failed: 2;
+};
+export type RequestStatus = (typeof RequestStatus)[keyof typeof RequestStatus];
+export declare const WalletKey: Record<typeof ChainId.Solana | typeof ChainId.Sui, bigint>;
+export declare const DWalletAddress: Record<typeof ChainId.Solana | typeof ChainId.Sui, string>;
+export declare const DWalletId: Record<typeof ChainId.Solana | typeof ChainId.Sui, string>;
+export declare const XCoreWalletId: Record<typeof ChainId.Solana | typeof ChainId.Sui, string>;
+export declare const XCORE_PACKAGE_ID = "0x0966345c144f5c8daec0560b2d8ed054ed704db5d0d75fb29801aca7ac88977d";
+export declare const TOKENS_PACKAGE_ID = "0x6ca737ee1a09538b3a1335d75f676300c88db1440086f77eb33c46ecf8c67b12";
+export declare const WRAPPED_SOL_OTW = "0x6ca737ee1a09538b3a1335d75f676300c88db1440086f77eb33c46ecf8c67b12::tokens::WrappedSol";
+export declare const WRAPPED_SUI_OTW = "0x6ca737ee1a09538b3a1335d75f676300c88db1440086f77eb33c46ecf8c67b12::tokens::WrappedSui";
+export declare const WRAPPED_SOL_TYPE = "0xb39fe0c60c140063923a723f4e0e5bc008d1593ae3c6a71aa89fed5dc3546c15::inbound::XToken<0x6ca737ee1a09538b3a1335d75f676300c88db1440086f77eb33c46ecf8c67b12::tokens::WrappedSol>";
+export declare const WRAPPED_SUI_TYPE = "0xb39fe0c60c140063923a723f4e0e5bc008d1593ae3c6a71aa89fed5dc3546c15::inbound::XToken<0x6ca737ee1a09538b3a1335d75f676300c88db1440086f77eb33c46ecf8c67b12::tokens::WrappedSui>";
+export declare const PRESIGN_CAP_TYPE = "0x0966345c144f5c8daec0560b2d8ed054ed704db5d0d75fb29801aca7ac88977d::presign_cap::PresignCap";
+export declare const WITNESS_TYPE = "0xb39fe0c60c140063923a723f4e0e5bc008d1593ae3c6a71aa89fed5dc3546c15::auth::Witness";
+export declare const PCR_LENGTH = 48;
+export declare const EMPTY_PCR: Uint8Array<ArrayBuffer>;
+export declare const SOLANA_WALLET_CONFIG: WalletConfig;
+export declare const SUI_WALLET_CONFIG: WalletConfig;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './constants';
+export * from './utils';
+export * from './xbridge.types';
+export * from './xbridge-inbound';
+export * from './xbridge-outbound';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}