Common Errors

# Clone LayerZero repo
git clone https://github.com/LayerZero-Labs/LayerZero-v2.git

# Update Move.toml to use local paths
[dependencies]
OApp = { local = "../LayerZero-v2/packages/layerzero-v2/sui/contracts/oapps/oapp" }
EndpointV2 = { local = "../LayerZero-v2/packages/layerzero-v2/sui/contracts/endpoint-v2" }
# ... other packages

sui client publish --with-unpublished-dependencies --gas-budget 200000000

// Package 1: Core logic
module my_oapp::core {
    // Essential functions
}

// Package 2: Utilities
module my_oapp::utils {
    // Helper functions
}

sui client publish --gas-budget 200000000

sui client objects | grep UpgradeCap

sui client call \
    --package $PACKAGE \
    --module oapp \
    --function initialize_channel \
    --args $OAPP_OBJECT $ADMIN_CAP 30101 \
    --gas-budget 10000000

sui client call \
    --package $PACKAGE \
    --module oapp \
    --function set_peer \
    --args $OAPP_OBJECT $ADMIN_CAP 30101 $PEER_ADDRESS_BYTES \
    --gas-budget 10000000

sui client call \
    --package $PACKAGE \
    --module oapp \
    --function set_send_library \
    --args $OAPP_OBJECT $ADMIN_CAP 30101 $LIBRARY_ADDRESS \
    --gas-budget 10000000

# Query your OApp/OFT object
sui client object <YOUR_OAPP_OBJECT_ID> --json | jq '.data.type'

# Output example:
# "0x061a47bffa630b8cd3735f8479edf7ab7897863fb3b796e77ebb8786af6f1bfc::oapp::OApp"
#  ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
#  This is your package ID - use as peer address!

// On EVM/Solana/other chains, use Sui package ID:
await oapp.setPeer(
  30230, // Sui mainnet EID
  '0x061a47bffa630b8cd3735f8479edf7ab7897863fb3b796e77ebb8786af6f1bfc', // Package ID
);

// - Wrong: Using package ID as object
tx.object(packageId); // Package is not an object!

// - Correct: Use object ID
tx.object(oappObjectId); // The OApp object instance

# View transaction outputs after publishing
sui client publish --json

# objectChanges array shows:
# - "published" type = package ID
# - "created" type = object IDs

import {SDK, OAppUlnConfigBcs} from '@layerzerolabs/lz-sui-sdk-v2';

// CRITICAL: Import asBytes helper
const {asBytes} = await import('@layerzerolabs/lz-sui-sdk-v2');

// Encode configuration
const config = OAppUlnConfigBcs.serialize({
  use_default_confirmations: false,
  use_default_required_dvns: false,
  use_default_optional_dvns: true,
  uln_config: {
    confirmations: 15,
    required_dvns: [dvnAddress],
    optional_dvns: [],
    optional_dvn_threshold: 0,
  },
}).toBytes();

const tx = new Transaction();

// - WRONG: Using tx.pure() causes InvalidBCSBytes
tx.pure(config, 'vector<u8>');

// - CORRECT: Use asBytes() helper
asBytes(tx, config);

// In context:
tx.moveCall({
  target: '...',
  arguments: [
    // ... other args
    asBytes(tx, config), // ← This works
  ],
});

// Actual implementation from SDK utils/index.ts
export function asBytes(
  tx: Transaction,
  bytes: Uint8Array | TransactionArgument,
): TransactionArgument {
  if (isTransactionArgument(bytes)) {
    return bytes;
  }
  // Wraps in BCS vector encoding
  return tx.pure(bcs.vector(bcs.u8()).serialize(Array.from(bytes)).toBytes());
}

const tx = new Transaction();
const [lzReceiveInfo] = tx.moveCall({
    target: `${oftPackage}::oft_ptb_builder::lz_receive_info`,
    typeArguments: [tokenType],
    arguments: [
        tx.object(oftObjectId),
        tx.object(endpointObjectId),
        tx.object('0xfbece0b75d097c31b9963402a66e49074b0d3a2a64dd0ed666187ca6911a4d12'),  // OFTComposerManager
        tx.object('0x6'),  // Clock
    ],
});

const result = await client.devInspectTransactionBlock({
    transactionBlock: tx,
    sender: yourAddress,
});
const lzReceiveInfoBytes = bcs.vector(bcs.u8()).parse(...);

import {asBytes} from '@layerzerolabs/lz-sui-sdk-v2';

const tx = new Transaction();
tx.moveCall({
  target: `${oappPackage}::endpoint_calls::set_oapp_info`,
  arguments: [
    tx.object(oappObjectId),
    tx.object(adminCapId),
    tx.object(endpointObjectId),
    asBytes(tx, oappInfoBytes), // Includes lz_receive_info
  ],
});

await client.signAndExecuteTransaction({transaction: tx});

# Find your package ID
sui client object <YOUR_OAPP_OBJECT_ID> --json | jq '.data.type'
# Example: "0x061a47bf...::oapp::OApp"
#           ^^^^^^^^^^^^
# Use this package ID as peer on remote chains

// On EVM
oapp.setPeer(30230, bytes32(0x061a47bffa630b8cd3735f8479edf7ab7897863fb3b796e77ebb8786af6f1bfc));  // Package ID

// - Incorrect: Call not confirmed
let call = oapp::send(&mut oapp, &call_cap, ...);
// Transaction ends → ERROR

// - Correct: Call confirmed and destroyed
let call = oapp::send(&mut oapp, &call_cap, ...);
// PTB processes the Call through Endpoint/ULN/Workers
let (params, receipt) = oapp::confirm_lz_send(&oapp, &call_cap, call);

# Dry run to see simulation errors
sui client call ... --json --dry-run

// Correct PTB structure for send
const tx = new Transaction();

// 1. Call OApp
tx.moveCall({
  target: `${oappPackage}::oapp::send`,
  arguments: [
    /* ... */
  ],
});

// 2. PTB will route Hot Potatoes automatically
// 3. Confirm calls are added by the builder

await client.signAndExecuteTransaction({transaction: tx});

sui client object <OBJECT_ID> --json | jq '.data.owner'

// - Correct: AdminCap owned by signer
public fun set_peer(
    oapp: &mut OApp,     // Shared object (anyone can reference)
    admin_cap: &AdminCap, // Owned object (must own to use)
    ...
)

// Deleting object frees storage
let MyObject { id, data } = obj;
object::delete(id); // Triggers rebate

const client = new SuiClient({
  url: 'https://fullnode.mainnet.sui.io:443',
  timeout: 60000, // 60 seconds
});

// - Correct
const objectId = '0x1234...'; // 64 hex chars (32 bytes)

// - Incorrect
const objectId = '0x123'; // Too short
const objectId = '1234...'; // Missing 0x prefix

// Check coin type
const coin = await client.getObject({id: coinId});
console.log('Coin type:', coin.data?.type);

// Use correct coin type
const result = await oft.send({
  tokenMint: '0x...::token::TOKEN', // Must match
  // ...
});

# Sui CLI with verbose output
sui client call ... --json | jq .

const result = await client.signAndExecuteTransaction({
  transaction: tx,
  options: {
    showEffects: true,
    showEvents: true,
    showObjectChanges: true,
  },
});

console.log('Effects:', result.effects);
console.log('Events:', result.events);
console.log('Object changes:', result.objectChanges);

# View object details
sui client object $OBJECT_ID --json

# View all objects for an address
sui client objects --json

# Switch to devnet
sui client switch --env devnet

# Test your calls
sui client call ... --gas-budget 20000000