mintme-sdk
Version:
A simple and powerful SDK for creating and managing tokens on the Solana blockchain. MintMe SDK simplifies the process of minting SPL tokens with metadata, managing token authorities, and interacting with the Solana token ecosystem.
244 lines (236 loc) • 7.52 kB
JavaScript
/**
* Utilities for handling IDL (Interface Description Language)
*/
const fs = require("fs")
const path = require("path")
const constants = require("../constants")
/**
* Loads the IDL from a URL, an object, a file, or uses the default IDL
* @param {string|Object|null} idlSource - IDL URL, IDL object, file path, or null to use the default
* @returns {Promise<Object>} - The loaded IDL
*/
function loadIDL(idlSource) {
// If no IDL is provided, try to load from the default file
if (!idlSource) {
if (fs && path) {
try {
const defaultPath = path.resolve(constants.DEFAULT_IDL_PATH)
if (fs.existsSync(defaultPath)) {
return Promise.resolve(JSON.parse(fs.readFileSync(defaultPath, "utf-8")))
}
} catch (error) {
console.warn("Error loading IDL from default file:", error)
}
}
// If it can't be loaded from the file, use a basic embedded IDL
return Promise.resolve({
version: "0.1.0",
name: "token_creator",
instructions: [
{
name: "updateNetworkFee",
accounts: [
{ name: "config", isMut: true, isSigner: false },
{ name: "admin", isMut: true, isSigner: true },
{ name: "systemProgram", isMut: false, isSigner: false },
],
args: [
{ name: "newFeeLamports", type: "u64" },
],
},
{
name: "updateRevokeFee",
accounts: [
{ name: "config", isMut: true, isSigner: false },
{ name: "admin", isMut: true, isSigner: true },
{ name: "systemProgram", isMut: false, isSigner: false },
],
args: [
{ name: "newFeeLamports", type: "u64" },
],
},
{
name: "createToken",
accounts: [
{ name: "payer", isMut: true, isSigner: true },
{ name: "config", isMut: false, isSigner: false },
{ name: "mint", isMut: true, isSigner: false },
{ name: "tokenAccount", isMut: true, isSigner: false },
{ name: "metadata", isMut: true, isSigner: false },
{ name: "tokenPda", isMut: true, isSigner: false },
{ name: "tokenProgram", isMut: false, isSigner: false },
{ name: "metadataProgram", isMut: false, isSigner: false },
{ name: "systemProgram", isMut: false, isSigner: false },
{ name: "partnerWallet", isMut: true, isSigner: false },
{ name: "rent", isMut: false, isSigner: false },
{
name: "associatedTokenProgram",
isMut: false,
isSigner: false,
},
],
args: [
{ name: "name", type: "string" },
{ name: "symbol", type: "string" },
{ name: "uniqueKey", type: "string" },
{ name: "decimals", type: "u8" },
{ name: "initialSupply", type: "u64" },
{ name: "uri", type: "string" },
{ name: "revokeMint", type: "bool" },
{ name: "revokeFreeze", type: "bool" },
{ name: "partnerWallet", type: "publicKey" },
{ name: "partnerAmount", type: "u64" },
],
},
{
name: "revokeAuthority",
accounts: [
{ name: "owner", isMut: true, isSigner: true },
{ name: "mint", isMut: true, isSigner: false },
{ name: "tokenProgram", isMut: false, isSigner: false },
{ name: "systemProgram", isMut: false, isSigner: false },
{ name: "tokenPda", isMut: true, isSigner: false },
{ name: "payer", isMut: true, isSigner: true },
{ name: "config", isMut: false, isSigner: false },
{ name: "partnerWallet", isMut: true, isSigner: false },
],
args: [
{ name: "revokeMint", type: "bool" },
{ name: "revokeFreeze", type: "bool" },
{ name: "partnerWallet", type: "publicKey" },
{ name: "partnerAmount", type: "u64" },
],
},
],
accounts: [
{
name: "NetworkFeeConfig",
type: {
kind: "struct",
fields: [
{
name: "feeLamports",
type: "u64",
},
{
name: "bump",
type: "u8",
},
],
},
},
{
name: "RevokeFeeConfig",
type: {
kind: "struct",
fields: [
{
name: "feeRevokeLamports",
type: "u64",
},
{
name: "bump",
type: "u8",
},
],
},
},
],
errors: [
{
code: 6000,
name: "NoFreezeAuthority",
msg: "The mint has no freeze authority",
},
{
code: 6001,
name: "NoMintAuthority",
msg: "The mint has no mint authority",
},
{
code: 6002,
name: "InvalidPDA",
msg: "Invalid PDA",
},
{
code: 6003,
name: "InvalidReceiver",
msg: "Invalid receiver address",
},
{
code: 6004,
name: "InsufficientFunds",
msg: "Insufficient funds in payment account",
},
{
code: 6005,
name: "MissingPartnerAccount",
msg: "Not funds.",
},
{
code: 6006,
name: "UnauthorizedClaim",
msg: "Unauthorized claim attempt",
},
{
code: 6007,
name: "InvalidCommissionWallet",
msg: "Invalid Network Fee Wallet",
},
{
code: 6008,
name: "UnauthorizedAdmin",
msg: "Unauthorized admin",
},
{
code: 6009,
name: "UnauthorizedOwner",
msg: "The signer is not the Owner",
},
{
code: 6010,
name: "NoAuthoritySpecified",
msg: "No authority specified to revoke",
},
],
})
}
// If it's an object, use it directly
if (typeof idlSource === "object") {
return Promise.resolve(idlSource)
}
// If it's a string, it could be a URL or a file path
if (typeof idlSource === "string") {
// First try to load as a file if we're in Node.js
if (fs && path) {
try {
const resolvedPath = path.resolve(idlSource)
if (fs.existsSync(resolvedPath)) {
return Promise.resolve(JSON.parse(fs.readFileSync(resolvedPath, "utf-8")))
}
} catch (error) {
console.warn("Error loading IDL from file:", error)
}
}
// If it couldn't be loaded as a file or we're not in Node.js, try as a URL
if (typeof fetch === "undefined") {
return Promise.reject(new Error("fetch is not available in this environment. Please use a fetch polyfill."))
}
return fetch(idlSource)
.then((response) => {
if (!response.ok) {
throw new Error("Error loading IDL: " + response.statusText)
}
return response.json()
})
.catch((error) => {
console.error("Error loading IDL from URL:", error)
throw error
})
}
// If we get here, the idlSource type is not valid
return Promise.reject(new Error("Invalid IDL source type"))
}
module.exports = {
loadIDL,
}