3land_sdk 1.0.0

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "3land_sdk",
+  "version": "1.0.0",
+  "description": "sdk for interacting with 3land's solana program",
+  "main": "./src/library/implementation/storeImplementation.ts",
+  "type": "module",
+  "scripts": {
+    "test": "npx tsx ./src/index.ts"
+  },
+  "author": "biccs",
+  "license": "ISC",
+  "dependencies": {
+    "@coral-xyz/borsh": "^0.30.1",
+    "@irys/sdk": "^0.2.11",
+    "@metaplex-foundation/beet": "^0.7.2",
+    "@metaplex-foundation/mpl-token-metadata": "^2.13.0",
+    "@project-serum/anchor": "^0.26.0",
+    "@solana/web3.js": "^1.95.4",
+    "bn": "^1.0.5",
+    "bn.js": "^5.2.1",
+    "bs58": "^6.0.0",
+    "cyrb53": "^1.0.0",
+    "fs": "^0.0.1-security",
+    "irys": "^0.0.1",
+    "node-fetch": "^3.3.2",
+    "ts-node": "^10.9.2",
+    "tweetnacl": "^1.0.3"
+  },
+  "devDependencies": {
+    "@types/bn.js": "^5.1.6",
+    "@types/node": "^22.7.7",
+    "tsx": "^4.19.1",
+    "typescript": "^5.6.3"
+  }
+}

package/src/index.ts

@@ -0,0 +1,89 @@
+import { SendTransactionError } from "@solana/web3.js";
+import {
+  createSingleImp,
+  createStoreImp,
+  buySingleImp,
+  handleError,
+} from "./library/implementation/storeImplementation";
+import {
+  CreateCollectionOptions,
+  CreateSingleOptions,
+  CreateStoreParams,
+  StoreInitOptions,
+} from "./types/implementation/implementationTypes";
+
+async function main() {
+  //   const options: StoreInitOptions = {
+  //     walletPath: "", //route to keypair.json generated from the solana cli
+  //   };
+
+  const optionsWithBase58: StoreInitOptions = {
+    privateKey:
+      "2ixmpz6W9aAE7HDqCJYy1tsqQcAHhkuP54jTPGnTyqvYHJearwT16DzmkkaQLARB9TshZvoS3WE5dQg183wryVCC",
+  };
+
+  const storeSetup: CreateStoreParams = {
+    storeName: "Super cool store",
+    storeFee: 5,
+  };
+
+  const collectionOpts: CreateCollectionOptions = {
+    collectionName: "Super awesome Collection",
+    collectionSymbol: "SAC",
+    collectionDescription: "This is a collection for the cool guys",
+  };
+
+  const createItemOptions: CreateSingleOptions = {
+    itemName: "supercoolitem7",
+    sellerFee: 500,
+    itemSymbol: "SCI7",
+    itemDescription: "implementing link imgs",
+    traits: [
+      { trait_type: "type", value: "cool" },
+      { trait_type: "creator", value: "me" },
+    ],
+    price: 100000000, //100000000 == 0.1 sol
+    mainImageUrl:
+      "https://arweave.net/FMkKYYsheEImBfejYaPPoJbI3CxJxunwvErD9VYzxOY?ext=jpeg",
+  };
+
+  try {
+    //image url: https://arweave.net/FMkKYYsheEImBfejYaPPoJbI3CxJxunwvErD9VYzxOY?ext=jpeg
+    //image aI:  https://oaidalleapiprodscus.blob.core.windows.net/private/org-gqKriRsgW5z3sjYXrQv0vXPk/user-dhUswyb2oCg8NHc1yhPldLys/img-vX5am1Oagbimd9uSWnrSlUPb.png?st=2024-12-29T02%3A12%3A51Z&se=2024-12-29T04%3A12%3A51Z&sp=r&sv=2024-08-04&sr=b&rscd=inline&rsct=image/png&skoid=d505667d-d6c1-4a0a-bac7-5c84a87759f8&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skt=2024-12-28T21%3A04%3A53Z&ske=2024-12-29T21%3A04%3A53Z&sks=b&skv=2024-08-04&sig=ltGieu7AXXJUhIF7hyTPXmnnFVKTu5BwmifIB3kLqAY%3D
+    // Create store
+    //const storeResult = await createStoreTest(optionsWithBase58, storeSetup);
+    //console.log("Store created. Transaction ID:", storeResult.transactionId);
+    const landStoreMainnet = "AmQNs2kgw4LvS9sm6yE9JJ4Hs3JpVu65eyx9pxMG2xA";
+    const landStoreDevnet = "GyPCu89S63P9NcCQAtuSJesiefhhgpGWrNVJs4bF2cSK";
+    // Create Collection
+    // const collection = await createCollectionTest(
+    //   optionsWithBase58,
+    //   collectionOpts
+    // );
+    // console.log("collection mint: ", collection);
+    // Create single edition
+    // const storeAccount = "3MwBR619SgJ35ek7vDLxxE5QvBaNq1fmmEZSXKW2X3Lf"; //"P1c4bboejX24NbY3vMw8EncKVmvcGEryznWLs4PGp9j"; //current store created for testing
+    const collectionAccount = "Fpm8XgXEuNxxjmqUQuqEFkGusiSsKM6astUGPs5U9x6v"; //"2rQq34FJG1613i7H8cDfxuGCtEjJmFAUNbAPJqK699oD";
+    const singleEditionResult = await createSingleImp(
+      optionsWithBase58,
+      landStoreDevnet,
+      collectionAccount,
+      createItemOptions
+    );
+    console.log(
+      "Single edition created. Transaction ID:",
+      singleEditionResult.transactionId
+    );
+    // Buy single edition
+    // const itemAccount = "8iUHPXuZWQdSGTV9X8hPdUgxSLfdXX7YjZYMck2TALBc"; //"7BhKXmc5obiwn5hhrUhErVBrAT7TErYcTpRYE8ggfjKV"; //current item created for testing
+    // const buyResult = await buySingleTest(options, itemAccount);
+    // console.log(
+    //   "Single edition purchased. Transaction ID:",
+    //   buyResult.transactionId
+    // );
+  } catch (error) {
+    handleError(error);
+  }
+}
+
+main();

package/src/library/Irys/irys.ts

@@ -0,0 +1,412 @@
+import { WebIrys, NodeIrys } from "@irys/sdk";
+import { sleep, nowS } from "../../utility/utils";
+import { toPublicKey } from "../../utility/PdaManager";
+import crypto from "crypto";
+import { SystemProgram, Keypair, PublicKey } from "@solana/web3.js";
+import nacl from "tweetnacl";
+
+interface IrysTransaction {
+  upload(): Promise<any>;
+  // Add other transaction properties you're using
+}
+
+interface IrysFile {
+  type: string;
+  name: string;
+  nonce?: string;
+  arrayBuffer(): Promise<ArrayBuffer>;
+  is_metadata?: boolean;
+  status?: string;
+  arweave?: string;
+  data?: any;
+  payload?: boolean;
+  transaction?: string | IrysTransaction; // Can be either string or transaction object
+  irys?: {
+    id: string;
+    size: number;
+    url: string;
+    extension: string | null;
+    nonce: string;
+    transaction: IrysTransaction;
+    irys_wallet: string;
+    price: number;
+    slippage_fee: number;
+  };
+}
+
+export interface UploadOptions {
+  uuid: string;
+  signature: any;
+  // files: IrysFile[];
+}
+
+interface RegisterOptions {
+  files: IrysFile[];
+  uuid: string;
+}
+
+interface FundingInstructionsOptions {
+  files: any; //IrysFile[] | undefined
+  payer: string | PublicKey | boolean;
+}
+
+export class IrysHelper {
+  private irys!: WebIrys | NodeIrys;
+  private wallet!: Keypair;
+  private owner!: string;
+  private files_bridge: { [key: string]: IrysFile };
+
+  constructor() {
+    this.files_bridge = {};
+  }
+
+  // private irys?: WebIrys;
+  // private wallet?: Keypair;
+  // private owner?: string;
+
+  private ensureInitialized(): void {
+    if (!this.irys || !this.wallet || !this.owner) {
+      throw new Error(
+        "IrysHelper not properly initialized. Call init() first."
+      );
+    }
+  }
+
+  // async verifyBalance(id: any): Promise<boolean> {
+  //   this.ensureInitialized();
+  //   try {
+  //     const fundtx = await this.irys.fund(id);
+  //     return !!fundtx;
+  //   } catch (e) {
+  //     console.log("CANNOT VERIFY FUND", e);
+  //   }
+  //   return false;
+  // }
+
+  // async getBalance(): Promise<any> {
+  //   this.ensureInitialized();
+  //   return this.irys.getLoadedBalance();
+  // }
+
+  async verifyBalance(id: any) {
+    try {
+      const submited = await this.irys.funder.submitTransaction(id);
+      return submited;
+    } catch (e) {
+      console.log("CANNOT VERIFY FUND", e);
+    }
+    return false;
+  }
+  async getBalance() {
+    return this.irys.getLoadedBalance();
+  }
+
+  async bundle(file: IrysFile, is_metadata = false): Promise<IrysFile> {
+    console.log("BUNDLE: ", file);
+    console.log("BUNDLE method: ", file.arrayBuffer());
+
+    this.ensureInitialized();
+    try {
+      const { type, name } = file;
+      const nonce =
+        file.nonce || crypto.randomBytes(32).toString("base64").slice(0, 32);
+      const tags = [{ name: "Content-Type", value: type }];
+      const irys_wallet = this.irys.address;
+      const arrayBuffer = await file.arrayBuffer();
+      console.log("main image buffer 2: ", arrayBuffer);
+      const buffer = Buffer.from(arrayBuffer);
+      console.log("main image buffer 3: ", arrayBuffer);
+
+      let transaction = this.irys.createTransaction(buffer, {
+        anchor: nonce,
+        tags,
+      });
+
+      console.log("TRANSACTION: ", transaction);
+
+      const { size } = transaction;
+      const price = await this.irys.getPrice(transaction.size);
+      const slippage_fee = Math.round(price.div(6).toNumber());
+      await transaction.sign();
+
+      const extension = this.getFileExtension(file);
+      const id = transaction?.id;
+      if (!id) throw "No id";
+
+      const url =
+        "https://arweave.net/" +
+        id +
+        (extension && !file.is_metadata && !is_metadata
+          ? "?ext=" + extension
+          : "");
+
+      file.payload = false;
+      file.irys = {
+        id,
+        size,
+        url,
+        extension,
+        nonce,
+        transaction,
+        irys_wallet,
+        price: price.toNumber(),
+        slippage_fee,
+      };
+
+      return file;
+    } catch (e) {
+      console.log("ERRORE", e);
+      throw new Error("error in bundle Irys");
+    }
+  }
+
+  getFileExtension(file: IrysFile): string | null {
+    if (!file) {
+      return null;
+    }
+
+    // Try to get extension from filename
+    if (file.name) {
+      const parts = file.name.split(".");
+      if (parts.length > 1) {
+        const extension = parts.pop(); // Get last part
+        if (extension) {
+          return extension;
+        }
+      }
+    }
+
+    // Fallback to MIME type
+    if (file.type) {
+      const parts = file.type.split("/");
+      if (parts.length > 1) {
+        return parts[1];
+      }
+    }
+
+    return null;
+  }
+
+  private parseTransaction(transactionStr: any): string | null {
+    try {
+      const parsed = JSON.parse(transactionStr);
+      return Array.isArray(parsed) ? parsed[0] : null;
+    } catch (e) {
+      console.log("Error parsing transaction:", e);
+      return null;
+    }
+  }
+
+  async getFundingInstructions({ files, payer }: FundingInstructionsOptions) {
+    this.ensureInitialized();
+    if (!payer) payer = this.owner;
+
+    let bytes = 0;
+    let price: any = false;
+    if (!files) return;
+    for (const file of files) {
+      if (!file.irys) {
+        throw new Error("File not properly bundled");
+      }
+      const files_price = await this.irys.getPrice(file.irys.size);
+      if (!price) {
+        price = files_price;
+      } else {
+        price = price.plus(files_price);
+      }
+      bytes += file.irys.size;
+      file.irys.price = price.toNumber();
+    }
+
+    const irys_address = await this.irys.utils.getBundlerAddress("solana");
+    const slippage_fee = Math.round(price.div(6).toNumber());
+    price = price.plus(slippage_fee);
+    const from_user_to_manager = SystemProgram.transfer({
+      fromPubkey: toPublicKey(payer),
+      toPubkey: this.wallet.publicKey,
+      lamports: price,
+    });
+
+    const from_manager_to_irys = SystemProgram.transfer({
+      fromPubkey: this.wallet.publicKey,
+      toPubkey: toPublicKey(irys_address),
+      lamports: price,
+    });
+
+    return {
+      instructions: [from_user_to_manager, from_manager_to_irys],
+      bytes,
+      price: price.toNumber(),
+    };
+  }
+
+  async generateWallet(): Promise<Keypair> {
+    return Keypair.generate();
+  }
+
+  async getWallet(): Promise<Keypair> {
+    return this.wallet;
+  }
+
+  private arweaveToID(x: string): string {
+    return "irys-preupload-" + x;
+  }
+
+  async uploadFiles({ uuid, signature }: UploadOptions) {
+    this.ensureInitialized();
+    await this.irys.ready();
+
+    const files = [];
+    for (const file in this.files_bridge) {
+      files.push(this.files_bridge[file]);
+    }
+
+    await this.verifyBalance(signature);
+
+    const errors: string[] = [];
+    const succeeds: string[] = [];
+
+    for (const _file of files) {
+      if (!_file.irys) {
+        continue;
+      }
+
+      if (_file.status == "uploaded" && _file.arweave) {
+        succeeds.push(_file.arweave);
+        continue;
+      }
+
+      const blob = this.files_bridge[this.arweaveToID(_file.irys.id)];
+
+      if (!blob) {
+        errors.push(_file.irys.id);
+        continue;
+      }
+
+      blob.nonce = _file.irys.nonce;
+      const bundled = await this.bundle(blob);
+
+      if (!bundled || !bundled.irys || bundled.irys.id != _file.irys.id) {
+        errors.push(_file.irys.id);
+        continue;
+      }
+
+      try {
+        const subida = await bundled.irys.transaction.upload();
+        if (subida) {
+          succeeds.push(bundled.irys.id);
+        } else {
+          throw "";
+        }
+      } catch (e) {
+        const error = e + "";
+        if (error.includes("already received")) {
+          succeeds.push(bundled.irys.id);
+        } else {
+          errors.push(_file.irys.id);
+        }
+      }
+      await sleep(100);
+    }
+
+    const balance = await this.getBalance();
+    return { errors, succeeds };
+  }
+
+  async clean(): Promise<void> {}
+
+  async registerFiles({ files, uuid }: RegisterOptions): Promise<number> {
+    this.ensureInitialized();
+    const owner = this.owner;
+    this.files_bridge = {};
+
+    for (const [index, _file] of files.entries()) {
+      if (!_file.irys) {
+        continue;
+      }
+
+      const arweave = _file.irys.id;
+      const data = {
+        type: _file.type,
+        nonce: _file.irys.nonce,
+        size: _file.irys.size,
+        fee_at_submit: _file.irys.price,
+        slippage_fee: _file.irys.slippage_fee,
+      };
+
+      const tosave = {
+        owner,
+        arweave,
+        uuid,
+        status: "waiting",
+        date: nowS(),
+        data,
+        payload: _file.payload,
+      };
+
+      this.files_bridge[this.arweaveToID(arweave)] = _file;
+    }
+
+    return files.length;
+  }
+
+  async sync(address: string): Promise<boolean> {
+    if (this.owner != address) {
+      return true;
+    }
+    return true;
+  }
+
+  async init(
+    address: string,
+    options: { arweave_rpc?: string; rpc?: string }
+  ): Promise<boolean> {
+    const irys_network =
+      options?.arweave_rpc || "https://arweave.devnet.irys.xyz";
+    const rpc = options?.rpc || "https://api.devnet.solana.com";
+
+    const wallet = await this.generateWallet();
+    if (!wallet) return false;
+    this.wallet = wallet;
+
+    const provider = {
+      publicKey: wallet.publicKey,
+      signMessage: async (message: Uint8Array) => {
+        return nacl.sign.detached(message, this.wallet.secretKey);
+      },
+    };
+
+    this.owner = address;
+
+    this.irys = new NodeIrys({
+      // url: irys_network,
+      token: "solana",
+      key: wallet.secretKey,
+      network: "devnet",
+      config: { providerUrl: irys_network },
+      // wallet: { rpcUrl: rpc, provider },
+    });
+
+    await this.irys.ready();
+    const to = await this.irys.utils.getBundlerAddress("solana");
+    const bal = await this.getBalance();
+    return true;
+  }
+}
+
+let global: IrysHelper | null = null;
+
+export const init = async (
+  address: string,
+  options: { arweave_rpc?: string; rpc?: string }
+): Promise<IrysHelper | null> => {
+  if (global) {
+    const g = await global.sync(address);
+    if (!g) global = null;
+    return global;
+  }
+  global = new IrysHelper();
+  const g = await global.init(address, options);
+  if (!g) global = null;
+  return global;
+};