LayerZero V2 Solana OFT SDK

You can use the Solana OFT SDK - @layerzerolabs/oft-v2-solana-sdk library to interact with your Solana OFT. Setting up a project using the LayerZero CLI would have given you scripts under the tasks/solana folder that utilizes the Solana OFT SDK. You can refer to tasks/common/sendOFT.ts for the example usage.

Using the Solana OFT SDK in the Frontend

The Solana OFT SDK has been updated to be browser-compatible. Versions prior to 3.0.71 required more additional configurations via your bundling tool.

Next
Vite

For Next projects, no additional configurations are required to use the Solana OFT SDK.

For Vite projects, the following are the minimal configurations required to work. nodePolyfills is required as Buffer is required by @solana/web3.js but Vite does not polyfill it by default.

// vite.config.ts
import {defineConfig} from 'vite';
import react from '@vitejs/plugin-react';
import {nodePolyfills} from 'vite-plugin-node-polyfills';

// https://vite.dev/config/
export default defineConfig({
  plugins: [react(), nodePolyfills()],
});

Requirements

@layerzerolabs/oft-v2-solana-sdk@^3.0.86
@layerzerolabs/lz-v2-utilities@^3.0.86
@layerzerolabs/lz-definitions@^3.0.86
@metaplex-foundation/umi@^0.9.2
@metaplex-foundation/umi-bundle-defaults@^0.9.2
@metaplex-foundation/umi-signer-wallet-adapters@^0.9.2
@solana/web3.js@^1.95.8

Applying overrides for `@solana/web3.js`

In package.json add the following resolutions / overrides to ensure a consistent version of @solana/web3.js is used:

"overrides": {
  "@solana/web3.js": "~1.95.8"
}

Compatibility with `@solana/web3.js`

Under the hood, uses @metaplex-foundation/umi, which is an alternative to @solana/web3.js. If your project is using @solana/web3.js, you can utilize adapters for @solana/web3.js.

Troubleshooting

`Invalid Connection`

This can occur when there are multiple incompatible versions of @solana/web3.js. We need to ensure a consistent version is used due to the usage of @metaplex-foundation/umi@^0.9.2. To verify that this is the issue, run npm ls @solana/web3.js and check whether there are multiple versions of @solana/web3.js in the output. To solve this issue, do the following:

delete your node_modules folder
delete your package manager’s lockfile
in your package.json, specify @solana/web3.js@^1.95.8 as the dependency and also apply overrides
rerun your package manager install command.

LayerZero for Solana

Program Standards

Technical Reference

Troubleshooting

Resources

LayerZero V2 Solana OFT SDK

Using the Solana OFT SDK in the Frontend

Requirements

Applying overrides for `@solana/web3.js`

Compatibility with `@solana/web3.js`

Troubleshooting

`Invalid Connection`

LayerZero for Solana

Program Standards

Technical Reference

Troubleshooting

Resources

​Using the Solana OFT SDK in the Frontend

​Requirements

​Applying overrides for @solana/web3.js

​Compatibility with @solana/web3.js

​Troubleshooting

​Invalid Connection

Using the Solana OFT SDK in the Frontend

Requirements

Applying overrides for `@solana/web3.js`

Compatibility with `@solana/web3.js`

Troubleshooting

`Invalid Connection`