1.0.0-alpha.15 • Published 11 months ago

@mirrorworld/library.assetminting.new v1.0.0-alpha.15

Weekly downloads
-
License
MIT
Repository
-
Last release
11 months ago

This SDK contains the client side methods for the Asset Minting Solana Program

Installation

🚨 Please make sure to add this NPM token in your .npmrc file: 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

yarn add @mirrorworld/library.assetminting

Usage

Import the AssetMintingLib instance into your client. It expects a connection and wallet instance. You can get these by using one of the Solana Wallet Adapters your application will use to connect to a Solana RPC.

These transactions require you to sign the transaction using your wallet. That means you need to have SOL. You can request SOL from the SolFaucet

import {
    AssetMintingLib,
    ASSET_MINTING_PROGRAM_ID
} from '@mirrorworld/library.assetminting';

const connection = useConnection()

/** Make sure your wallet is initialized and connected to the browser before providing to GameWalletLib */
const wallet = useWallet()

/** GameWalletLib instance */
const assetMintingLib = new AssetMintingLib(
    ASSET_MINTING_PROGRAM_ID,
    connection,
    wallet
);

Demo

Example: You can see example project in this repo here:

Initialize Config Account

The Config Account PDA is the main part of the program which created from the name seed (the default seed define in the SDK is "MirrorWorld"), in the config account we add the signing authority

let tx = await assetMintingLib.createInitializeConfigTransaction(signingAuthorityWalletKeypair.publicKey, signingAuthorityWalletKeypair.publicKey, NAME);

await assetMintingLib.addFeePayerAndRecentBlockHashInTransaction(tx, signingAuthorityWalletKeypair.publicKey);

assetMintingLib.signTransaction(tx, signingAuthorityWalletSecretKey);

let txHash = await connection.sendRawTransaction(tx.serialize());
console.log("Tx Hash: ", txHash);

See example here

Create Collection

The Create Collection is like helper method with help of this method we can create the collection and signing authority as the update authority

let tx = await assetMintingLib.createCollectionTokenTransaction(collectionUuid, userWalletKeypair.publicKey, signingAuthorityWalletKeypair.publicKey,
    userWalletKeypair.publicKey, userWalletKeypair.publicKey, tokenName, tokenSymbol, tokenUrl, true, 0, creators, NAME,
    SystemProgram.programId, SYSVAR_RENT_PUBKEY, ASSOCIATED_TOKEN_PROGRAM_ID, TOKEN_PROGRAM_ID, mpl_programId);

// Adding Instructions for verifying the creators
await assetMintingLib.createAndAddCreatorSignMetadataInstruction(tx, collectionUuid, userWalletKeypair.publicKey, mpl_programId);

await assetMintingLib.addFeePayerAndRecentBlockHashInTransaction(tx, userWalletKeypair.publicKey);

assetMintingLib.signTransaction(tx, signingAuthorityWalletSecretKey);
assetMintingLib.signTransaction(tx, userWalletSecretKey);

let txHash = await connection.sendRawTransaction(tx.serialize(), {skipPreflight: false});

console.log("Tx Hash: ", txHash);

See example here

Create Sub Collection

The Create Sub Collection is like helper method with help of this method we can create the Sub collection and signing authority as the update authority

let tx = await assetMintingLib.createSubCollectionTokenTransaction(collectionUuid, subCollectionUuid, userWalletKeypair.publicKey, signingAuthorityWalletKeypair.publicKey,
    userWalletKeypair.publicKey, userWalletKeypair.publicKey, tokenName + "1", tokenSymbol, tokenUrl, true, 0, creators, NAME,
    signingAuthorityWalletKeypair.publicKey, SystemProgram.programId, SYSVAR_RENT_PUBKEY, ASSOCIATED_TOKEN_PROGRAM_ID, TOKEN_PROGRAM_ID, mpl_programId);

// Adding Instructions for verifying the creators
await assetMintingLib.createAndAddCreatorSignMetadataInstruction(tx, subCollectionUuid, userWalletKeypair.publicKey, mpl_programId);

await assetMintingLib.addFeePayerAndRecentBlockHashInTransaction(tx, userWalletKeypair.publicKey);

assetMintingLib.signTransaction(tx, signingAuthorityWalletSecretKey);
assetMintingLib.signTransaction(tx, userWalletSecretKey);

let txHash = await connection.sendRawTransaction(tx.serialize(), {skipPreflight: false});

console.log("Tx Hash: ", txHash);

See example here

Create Asset

This method creates the asset and verify the collection

let tx = await assetMintingLib.createAssetTokenTransaction(assetUuid, subCollectionUuid, userWalletKeypair.publicKey, signingAuthorityWalletKeypair.publicKey,
    userWalletKeypair.publicKey, userWalletKeypair.publicKey, tokenName + "2", tokenSymbol, tokenUrl, true, 550, creators, NAME,
    signingAuthorityWalletKeypair.publicKey, SystemProgram.programId, SYSVAR_RENT_PUBKEY, ASSOCIATED_TOKEN_PROGRAM_ID, TOKEN_PROGRAM_ID, mpl_programId);

// Adding Instructions for verifying the creators
await assetMintingLib.createAndAddCreatorSignMetadataInstruction(tx, assetUuid, userWalletKeypair.publicKey, mpl_programId);

await assetMintingLib.addFeePayerAndRecentBlockHashInTransaction(tx, userWalletKeypair.publicKey);

assetMintingLib.signTransaction(tx, signingAuthorityWalletSecretKey);
assetMintingLib.signTransaction(tx, userWalletSecretKey);

let txHash = await connection.sendRawTransaction(tx.serialize(), {skipPreflight: false});

console.log("Tx Hash: ", txHash);

See example here

Accounts

NameDescription
ConfigProgram config for the asset mint pda account