The following section will guide you through the implementation of the xcNFT cross-chain pallet for non-fungible assets.
Pallet docs - [link]
Before you begin with implementing this magical ✨ pallet into your Parachain, you must ensure that you meet fthe ollowing pre-requirements:
Substrate:
frame-benchmarkingframe-supportframe-system
Cumulus:
cumulus-primitives-corecumulus-pallet-xcm
XCMP:
xcm
SP:
sp-runtimesp-stdsp-coresp-io
Substrate Pallets:
- Either
pallet-nftsorpallet-uniquesdepending on which pallet your Parachain uses pallet-balancesparachain-info
Other pallets (Only needed for pallet_uniques xcnft version):
enumflags2
- If your Parachain uses pallet_nfts head over to xcnft for pallet_nfts section.
- If your Parachain uses pallet_uniques head over to xcnft for pallet_uniques section.
Don't know whether this pallet is useful for your Parachain?
No worries!
Try it out before you implement it!
Make sure your docker daemon is running Copy the Dockerfile from this repository and input following commands:
docker build --platform linux/x86_64 -t polkadot-sdk-image:latest .to build Docker imagedocker run --platform linux/x86_64 -p 9910-9913:9910-9913 -p 9920-9921:9920-9921 --rm -it polkadot-sdk-image:latestto start Zombienet.
Once Zombienet is started, continue from step 8 in the next section.
-
Fork or clone following repository
-
Download Zombienet binary for your system
-
Copy Zombienet binary into the binaries folder of the repository you just forked
-
Compile Relay chain by:
cd polkadotcargo build --release
- Compile first Parachain by:
cargo b -r -p parachain-template-node
- Compile second Parachain by:
cargo b -r -p parachain-template-node-two
- Launch Zombienet localhost network by:
cd binaries- Choose config that you wish to test:
./zombienet-macos-arm64 -p native -c 1 spawn config-both.tomllaunches network with 1 Relay chain, 1 Parachain with pallet_nfts and 1 Parachain with pallet_uniques (Best for testing pallet agnosticity)./zombienet-macos-arm64 -p native -c 1 spawn config-nfts.tomllaunches network with 1 Relay chain and 2 Parachains with pallet_nfts./zombienet-macos-arm64 -p native -c 1 spawn config-uniques.tomllaunches network with 1 Relay chain and 2 Parachains with pallet_uniques
- Once the network is launched, connect to one of the Relay chain nodes:
- Open HRMP channels for both chains (Needed for allowing cross-chain communication):
- Navigate to
Extrinsicstab select theAliceaccount and go toDecode- Paste the following hash to the Decode section:
0xff00fa05e8030000e90300000800000000040000(This hash opens the channel from chain 1000 to 1001) - Move back to Submission and sign the call with Alice
- Paste the following hash to Decode section
0xff00fa05e9030000e80300000800000000040000(This hash opens the channel from chain 1001 to 1000) - Move back to Submission and sign the call with Alice
- Paste the following hash to the Decode section:
- Start interacting with chains by connecting to their WS endpoints from the Zombienet console and try xcNFT out.
Don't know which function does what? Unsure what storage stores what?
Head over to User guide section.
To test the pallet, we constructed various unit tests using variations of data. To run these tests use the command:
Clone the following repository and run the following commands:
cargo test --package pallet-parachain-xcnft --lib -- tests --nocapture
cargo test --package pallet-parachain-xcnft-two --lib -- tests --nocapture
Soon (After pallet_nfts and pallet_uniques get released to newest version):
Choose pallet version and go to it's folder:
cd xcnft-pallet_nfts || xcnft-pallet_uniques
Run tests and benchmarks
cargo test
Made with 💛 by ParaSpell-Research✨
Published under MIT License.
