@ckbfs/api 2.0.3 → 2.0.5

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { Script, Signer, Transaction } from "@ckb-ccc/core";
 import { calculateChecksum, verifyChecksum, updateChecksum, verifyWitnessChecksum, verifyV3WitnessChecksum, verifyV3WitnessChain } from "./utils/checksum";
 import { createCKBFSCell, createPublishTransaction as utilCreatePublishTransaction, preparePublishTransaction, createAppendTransaction as utilCreateAppendTransaction, prepareAppendTransaction, createAppendTransactionDry, publishCKBFS as utilPublishCKBFS, appendCKBFS as utilAppendCKBFS, CKBFSCellOptions, PublishOptions, AppendOptions, AppendV3Options, TransferV3Options } from "./utils/transaction";
-import { readFile, readFileAsText, readFileAsUint8Array, writeFile, getContentType, splitFileIntoChunks, combineChunksToFile, getFileContentFromChain, saveFileFromChain, getFileContentFromChainByTypeId, saveFileFromChainByTypeId, decodeFileFromChainByTypeId, getFileContentFromChainByIdentifier, saveFileFromChainByIdentifier, decodeFileFromChainByIdentifier, parseIdentifier, IdentifierType, decodeWitnessContent, decodeMultipleWitnessContents, extractFileFromWitnesses, decodeFileFromWitnessData, saveFileFromWitnessData, getFileContentFromChainV3, getFileContentFromChainByIdentifierV3, saveFileFromChainByIdentifierV3 } from "./utils/file";
+import { readFile, readFileAsText, readFileAsUint8Array, writeFile, getContentType, splitFileIntoChunks, combineChunksToFile, getFileContentFromChain, saveFileFromChain, getFileContentFromChainByTypeId, saveFileFromChainByTypeId, decodeFileFromChainByTypeId, getFileContentFromChainByIdentifier, saveFileFromChainByIdentifier, decodeFileFromChainByIdentifier, parseIdentifier, IdentifierType, decodeWitnessContent, decodeMultipleWitnessContents, extractFileFromWitnesses, decodeFileFromWitnessData, saveFileFromWitnessData, getFileContentFromChainV3, getFileContentFromChainByIdentifierV3, saveFileFromChainByIdentifierV3, resolveCKBFSCell } from "./utils/file";
 import { createCKBFSWitness, createTextCKBFSWitness, extractCKBFSWitnessContent, isCKBFSWitness, createChunkedCKBFSWitnesses, createCKBFSV3Witness, createChunkedCKBFSV3Witnesses, extractCKBFSV3WitnessContent, isCKBFSV3Witness, CKBFSV3WitnessOptions } from "./utils/witness";
 import { CKBFSData, BackLinkV1, BackLinkV2, CKBFSDataType, BackLinkType, CKBFS_HEADER, CKBFS_HEADER_STRING } from "./utils/molecule";
 import { NetworkType, ProtocolVersion, ProtocolVersionType, DEFAULT_NETWORK, DEFAULT_VERSION, CKBFS_CODE_HASH, CKBFS_TYPE_ID, ADLER32_CODE_HASH, ADLER32_TYPE_ID, DEP_GROUP_TX_HASH, DEPLOY_TX_HASH, getCKBFSScriptConfig, CKBFSScriptConfig } from "./utils/constants";
@@ -28,9 +28,6 @@ export type PublishContentOptions = Omit<FileOptions, "capacity" | "contentType"
  */
 export type AppendContentOptions = Omit<FileOptions, "contentType" | "filename" | "capacity"> & {
     capacity?: bigint;
-    previousTxHash?: string;
-    previousWitnessIndex?: number;
-    previousChecksum?: number;
 };
 /**
  * Configuration options for the CKBFS SDK
@@ -197,4 +194,4 @@ export declare class CKBFS {
      */
     createPublishV3Transaction(filePath: string, options?: Omit<FileOptions, 'version'>): Promise<Transaction>;
 }
-export { calculateChecksum, verifyChecksum, updateChecksum, verifyWitnessChecksum, verifyV3WitnessChecksum, verifyV3WitnessChain, createCKBFSCell, utilCreatePublishTransaction as createPublishTransaction, preparePublishTransaction, utilCreateAppendTransaction as createAppendTransaction, prepareAppendTransaction, utilPublishCKBFS as publishCKBFS, utilAppendCKBFS as appendCKBFS, createAppendTransactionDry, readFile, readFileAsText, readFileAsUint8Array, writeFile, getContentType, splitFileIntoChunks, combineChunksToFile, getFileContentFromChain, saveFileFromChain, getFileContentFromChainByTypeId, saveFileFromChainByTypeId, decodeFileFromChainByTypeId, getFileContentFromChainByIdentifier, saveFileFromChainByIdentifier, decodeFileFromChainByIdentifier, parseIdentifier, IdentifierType, decodeWitnessContent, decodeMultipleWitnessContents, extractFileFromWitnesses, decodeFileFromWitnessData, saveFileFromWitnessData, getFileContentFromChainV3, getFileContentFromChainByIdentifierV3, saveFileFromChainByIdentifierV3, createCKBFSWitness, createTextCKBFSWitness, extractCKBFSWitnessContent, isCKBFSWitness, createChunkedCKBFSWitnesses, createCKBFSV3Witness, createChunkedCKBFSV3Witnesses, extractCKBFSV3WitnessContent, isCKBFSV3Witness, CKBFSV3WitnessOptions, CKBFSData, BackLinkV1, BackLinkV2, CKBFSDataType, BackLinkType, CKBFSCellOptions, PublishOptions, AppendOptions, CKBFS_HEADER, CKBFS_HEADER_STRING, NetworkType, ProtocolVersion, ProtocolVersionType, DEFAULT_NETWORK, DEFAULT_VERSION, CKBFS_CODE_HASH, CKBFS_TYPE_ID, ADLER32_CODE_HASH, ADLER32_TYPE_ID, DEP_GROUP_TX_HASH, DEPLOY_TX_HASH, getCKBFSScriptConfig, CKBFSScriptConfig, };
+export { calculateChecksum, verifyChecksum, updateChecksum, verifyWitnessChecksum, verifyV3WitnessChecksum, verifyV3WitnessChain, createCKBFSCell, utilCreatePublishTransaction as createPublishTransaction, preparePublishTransaction, utilCreateAppendTransaction as createAppendTransaction, prepareAppendTransaction, utilPublishCKBFS as publishCKBFS, utilAppendCKBFS as appendCKBFS, createAppendTransactionDry, readFile, readFileAsText, readFileAsUint8Array, writeFile, getContentType, splitFileIntoChunks, combineChunksToFile, getFileContentFromChain, saveFileFromChain, getFileContentFromChainByTypeId, saveFileFromChainByTypeId, decodeFileFromChainByTypeId, getFileContentFromChainByIdentifier, saveFileFromChainByIdentifier, decodeFileFromChainByIdentifier, parseIdentifier, IdentifierType, decodeWitnessContent, decodeMultipleWitnessContents, extractFileFromWitnesses, decodeFileFromWitnessData, saveFileFromWitnessData, getFileContentFromChainV3, getFileContentFromChainByIdentifierV3, saveFileFromChainByIdentifierV3, createCKBFSWitness, createTextCKBFSWitness, extractCKBFSWitnessContent, isCKBFSWitness, createChunkedCKBFSWitnesses, createCKBFSV3Witness, createChunkedCKBFSV3Witnesses, extractCKBFSV3WitnessContent, isCKBFSV3Witness, resolveCKBFSCell, CKBFSV3WitnessOptions, CKBFSData, BackLinkV1, BackLinkV2, CKBFSDataType, BackLinkType, CKBFSCellOptions, PublishOptions, AppendOptions, CKBFS_HEADER, CKBFS_HEADER_STRING, NetworkType, ProtocolVersion, ProtocolVersionType, DEFAULT_NETWORK, DEFAULT_VERSION, CKBFS_CODE_HASH, CKBFS_TYPE_ID, ADLER32_CODE_HASH, ADLER32_TYPE_ID, DEP_GROUP_TX_HASH, DEPLOY_TX_HASH, getCKBFSScriptConfig, CKBFSScriptConfig, };

package/dist/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CKBFSData = exports.isCKBFSV3Witness = exports.extractCKBFSV3WitnessContent = exports.createChunkedCKBFSV3Witnesses = exports.createCKBFSV3Witness = exports.createChunkedCKBFSWitnesses = exports.isCKBFSWitness = exports.extractCKBFSWitnessContent = exports.createTextCKBFSWitness = exports.createCKBFSWitness = exports.saveFileFromChainByIdentifierV3 = exports.getFileContentFromChainByIdentifierV3 = exports.getFileContentFromChainV3 = exports.saveFileFromWitnessData = exports.decodeFileFromWitnessData = exports.extractFileFromWitnesses = exports.decodeMultipleWitnessContents = exports.decodeWitnessContent = exports.IdentifierType = exports.parseIdentifier = exports.decodeFileFromChainByIdentifier = exports.saveFileFromChainByIdentifier = exports.getFileContentFromChainByIdentifier = exports.decodeFileFromChainByTypeId = exports.saveFileFromChainByTypeId = exports.getFileContentFromChainByTypeId = exports.saveFileFromChain = exports.getFileContentFromChain = exports.combineChunksToFile = exports.splitFileIntoChunks = exports.getContentType = exports.writeFile = exports.readFileAsUint8Array = exports.readFileAsText = exports.readFile = exports.createAppendTransactionDry = exports.appendCKBFS = exports.publishCKBFS = exports.prepareAppendTransaction = exports.createAppendTransaction = exports.preparePublishTransaction = exports.createPublishTransaction = exports.createCKBFSCell = exports.verifyV3WitnessChain = exports.verifyV3WitnessChecksum = exports.verifyWitnessChecksum = exports.updateChecksum = exports.verifyChecksum = exports.calculateChecksum = exports.CKBFS = void 0;
-exports.getCKBFSScriptConfig = exports.DEPLOY_TX_HASH = exports.DEP_GROUP_TX_HASH = exports.ADLER32_TYPE_ID = exports.ADLER32_CODE_HASH = exports.CKBFS_TYPE_ID = exports.CKBFS_CODE_HASH = exports.DEFAULT_VERSION = exports.DEFAULT_NETWORK = exports.ProtocolVersion = exports.NetworkType = exports.CKBFS_HEADER_STRING = exports.CKBFS_HEADER = exports.BackLinkV2 = exports.BackLinkV1 = void 0;
+exports.resolveCKBFSCell = exports.isCKBFSV3Witness = exports.extractCKBFSV3WitnessContent = exports.createChunkedCKBFSV3Witnesses = exports.createCKBFSV3Witness = exports.createChunkedCKBFSWitnesses = exports.isCKBFSWitness = exports.extractCKBFSWitnessContent = exports.createTextCKBFSWitness = exports.createCKBFSWitness = exports.saveFileFromChainByIdentifierV3 = exports.getFileContentFromChainByIdentifierV3 = exports.getFileContentFromChainV3 = exports.saveFileFromWitnessData = exports.decodeFileFromWitnessData = exports.extractFileFromWitnesses = exports.decodeMultipleWitnessContents = exports.decodeWitnessContent = exports.IdentifierType = exports.parseIdentifier = exports.decodeFileFromChainByIdentifier = exports.saveFileFromChainByIdentifier = exports.getFileContentFromChainByIdentifier = exports.decodeFileFromChainByTypeId = exports.saveFileFromChainByTypeId = exports.getFileContentFromChainByTypeId = exports.saveFileFromChain = exports.getFileContentFromChain = exports.combineChunksToFile = exports.splitFileIntoChunks = exports.getContentType = exports.writeFile = exports.readFileAsUint8Array = exports.readFileAsText = exports.readFile = exports.createAppendTransactionDry = exports.appendCKBFS = exports.publishCKBFS = exports.prepareAppendTransaction = exports.createAppendTransaction = exports.preparePublishTransaction = exports.createPublishTransaction = exports.createCKBFSCell = exports.verifyV3WitnessChain = exports.verifyV3WitnessChecksum = exports.verifyWitnessChecksum = exports.updateChecksum = exports.verifyChecksum = exports.calculateChecksum = exports.CKBFS = void 0;
+exports.getCKBFSScriptConfig = exports.DEPLOY_TX_HASH = exports.DEP_GROUP_TX_HASH = exports.ADLER32_TYPE_ID = exports.ADLER32_CODE_HASH = exports.CKBFS_TYPE_ID = exports.CKBFS_CODE_HASH = exports.DEFAULT_VERSION = exports.DEFAULT_NETWORK = exports.ProtocolVersion = exports.NetworkType = exports.CKBFS_HEADER_STRING = exports.CKBFS_HEADER = exports.BackLinkV2 = exports.BackLinkV1 = exports.CKBFSData = void 0;
 const core_1 = require("@ckb-ccc/core");
 const checksum_1 = require("./utils/checksum");
 Object.defineProperty(exports, "calculateChecksum", { enumerable: true, get: function () { return checksum_1.calculateChecksum; } });
@@ -47,6 +47,7 @@ Object.defineProperty(exports, "getFileContentFromChainV3", { enumerable: true,
     file_1.getFileContentFromChainV3; } });
 Object.defineProperty(exports, "getFileContentFromChainByIdentifierV3", { enumerable: true, get: function () { return file_1.getFileContentFromChainByIdentifierV3; } });
 Object.defineProperty(exports, "saveFileFromChainByIdentifierV3", { enumerable: true, get: function () { return file_1.saveFileFromChainByIdentifierV3; } });
+Object.defineProperty(exports, "resolveCKBFSCell", { enumerable: true, get: function () { return file_1.resolveCKBFSCell; } });
 const witness_1 = require("./utils/witness");
 Object.defineProperty(exports, "createCKBFSWitness", { enumerable: true, get: function () { return witness_1.createCKBFSWitness; } });
 Object.defineProperty(exports, "createTextCKBFSWitness", { enumerable: true, get: function () { return witness_1.createTextCKBFSWitness; } });
@@ -320,18 +321,18 @@ class CKBFS {
         const version = options.version || this.version;
         // Use V3 when backlink parameters are provided or version is V3
         if (version === constants_1.ProtocolVersion.V3 &&
-            options.previousTxHash &&
-            options.previousWitnessIndex !== undefined &&
-            options.previousChecksum !== undefined) {
+            ckbfsCell.outPoint.txHash &&
+            ckbfsCell.data.index !== undefined &&
+            ckbfsCell.data.checksum !== undefined) {
             const tx = await (0, transaction_1.appendCKBFSV3)(this.signer, {
                 ckbfsCell,
                 contentChunks,
                 feeRate: options.feeRate,
                 network: options.network || this.network,
                 version: constants_1.ProtocolVersion.V3,
-                previousTxHash: options.previousTxHash,
-                previousWitnessIndex: options.previousWitnessIndex,
-                previousChecksum: options.previousChecksum,
+                previousTxHash: ckbfsCell.outPoint.txHash,
+                previousWitnessIndex: ckbfsCell.data.index,
+                previousChecksum: ckbfsCell.data.checksum,
             });
             const txHash = await this.signer.sendTransaction(tx);
             return (0, transaction_2.ensureHexPrefix)(txHash);
@@ -507,18 +508,18 @@ class CKBFS {
         const version = options.version || this.version;
         // Use V3 when backlink parameters are provided or version is V3
         if (version === constants_1.ProtocolVersion.V3 &&
-            options.previousTxHash &&
-            options.previousWitnessIndex !== undefined &&
-            options.previousChecksum !== undefined) {
+            ckbfsCell.outPoint.txHash &&
+            ckbfsCell.data.index !== undefined &&
+            ckbfsCell.data.checksum !== undefined) {
             return (0, transaction_1.createAppendV3Transaction)(this.signer, {
                 ckbfsCell,
                 contentChunks,
                 feeRate: options.feeRate,
                 network: options.network || this.network,
                 version: constants_1.ProtocolVersion.V3,
-                previousTxHash: options.previousTxHash,
-                previousWitnessIndex: options.previousWitnessIndex,
-                previousChecksum: options.previousChecksum,
+                previousTxHash: ckbfsCell.outPoint.txHash,
+                previousWitnessIndex: ckbfsCell.data.index,
+                previousChecksum: ckbfsCell.data.checksum,
             });
         }
         else {

package/dist/utils/file.d.ts

@@ -138,6 +138,26 @@ export interface ParsedIdentifier {
  * @returns Parsed identifier information
  */
 export declare function parseIdentifier(identifier: string): ParsedIdentifier;
+/**
+ * Resolves a CKBFS cell using any supported identifier format
+ * @param client The CKB client to use for blockchain queries
+ * @param identifier The identifier (TypeID, CKBFS URI, or outPoint URI)
+ * @param options Optional configuration for network, version, and useTypeID
+ * @returns Promise resolving to the found cell and transaction info, or null if not found
+ */
+export declare function resolveCKBFSCell(client: any, identifier: string, options?: {
+    network?: "mainnet" | "testnet";
+    version?: string;
+    useTypeID?: boolean;
+}): Promise<{
+    cell: any;
+    transaction: any;
+    outPoint: {
+        txHash: string;
+        index: number;
+    };
+    parsedId: ParsedIdentifier;
+} | null>;
 /**
  * Retrieves complete file content from the blockchain using any supported identifier
  * @param client The CKB client to use for blockchain queries

package/dist/utils/file.js

@@ -52,6 +52,7 @@ exports.extractFileFromWitnesses = extractFileFromWitnesses;
 exports.decodeFileFromWitnessData = decodeFileFromWitnessData;
 exports.saveFileFromWitnessData = saveFileFromWitnessData;
 exports.parseIdentifier = parseIdentifier;
+exports.resolveCKBFSCell = resolveCKBFSCell;
 exports.getFileContentFromChainByIdentifier = getFileContentFromChainByIdentifier;
 exports.getFileContentFromChainByTypeId = getFileContentFromChainByTypeId;
 exports.saveFileFromChainByIdentifier = saveFileFromChainByIdentifier;

package/dist/utils/witness.js

@@ -161,9 +161,9 @@ function extractCKBFSV3WitnessContent(witness, isHeadWitness = true) {
         // Extract previous position
         const prevTxHashBytes = witness.slice(6, 38);
         const previousTxHash = '0x' + Array.from(prevTxHashBytes).map(b => b.toString(16).padStart(2, '0')).join('');
-        const previousWitnessIndex = new DataView(witness.slice(38, 42).buffer).getUint32(0, true);
-        const previousChecksum = new DataView(witness.slice(42, 46).buffer).getUint32(0, true);
-        const nextIndex = new DataView(witness.slice(46, 50).buffer).getUint32(0, true);
+        const previousWitnessIndex = new DataView(witness.slice(38, 42).buffer.slice(witness.slice(38, 42).byteOffset, witness.slice(38, 42).byteOffset + 4)).getUint32(0, true);
+        const previousChecksum = new DataView(witness.slice(42, 46).buffer.slice(witness.slice(42, 46).byteOffset, witness.slice(42, 46).byteOffset + 4)).getUint32(0, true);
+        const nextIndex = new DataView(witness.slice(46, 50).buffer.slice(witness.slice(46, 50).byteOffset, witness.slice(46, 50).byteOffset + 4)).getUint32(0, true);
         const content = witness.slice(50);
         return {
             version,

package/examples/nervape.ts

@@ -0,0 +1,406 @@
+import fs from "fs"
+import path from 'path';
+import { 
+  CKBFS, 
+  NetworkType, 
+  CKBFSDataType, 
+  ProtocolVersion,
+  CKBFSData,
+  getFileContentFromChain,
+  getCKBFSScriptConfig,
+  extractCKBFSV3WitnessContent,
+  isCKBFSV3Witness,
+  resolveCKBFSCell,
+} from '../src';
+import { 
+  Script, 
+  Address, 
+  ClientPublicTestnet, 
+  ClientPublicMainnet, 
+  Transaction,
+  ccc
+} from "@ckb-ccc/core";
+import { 
+  transferSpore
+} from "@ckb-ccc/spore";
+//import { isMainnet, network, CKB_PRIVATE_KEY } from "../config"
+
+
+const client = new ClientPublicTestnet()
+
+export const TestnetTraceLockDep = {
+  outPoint: {
+    txHash: "0xf6d5b0c8c5221cc9d158fd8556a3772c25a295b9f894eeb86291a25522cf90b0",
+    index: 0x0,
+  },
+  depType: "code",
+}
+
+export const MainnetTraceLockDep = {
+  outPoint: {
+    txHash: "0x...", //TODO: fill mainnet tracelock txhash
+    index: 0x0,
+  },
+  depType: "code",
+}
+
+export const TestnetShadowDep = {
+  outPoint: {
+    txHash: "0x2d8a311a55e42d7d6810610149f6e125f0d292112f8ed4a21177aec05da2b905",
+    index: 0x0,
+  },
+  depType: "code",
+}
+
+export const MainnetShadowDep = {
+  outPoint: {
+    txHash: "0x5b20ec7d7d5c6410ac4924c57d1eac1dd50129b6263be3dc93055397b5724dc2",
+    index: 0x0,
+  },
+  depType: "code",
+}
+
+
+const TraceLockDep = TestnetTraceLockDep
+const ShadowDep = TestnetShadowDep
+
+const TraceLogCodeHash = "0xbd7e56daaa4cc9ecf488a50d2f4db2a55a7c86eb2df2157d24a62be9be5b34ab"
+const ShadowSporeCodeHash = "0x6361d4b20d845953d9c9431bbba08905573005a71e2a2432e7e0e7c685666f24"
+const CKB_PRIVATE_KEY = "0x1733e6f7825f99eb41ca26f8569fa90c2cb8c5ae199bbd38a97562291f784983"
+
+const ckbfs = new CKBFS(
+  CKB_PRIVATE_KEY,
+   NetworkType.Testnet,
+  {
+    version: ProtocolVersion.V3,
+    chunkSize: 30 * 1024, // 30KB chunks
+    useTypeID: false // Use code hash instead of type ID
+  }
+);
+
+async function getAddressScriptHash(addr: string | Address) {
+  if (typeof addr === 'string') {
+    addr = await Address.fromString(addr, client)
+    console.log("addr=", addr)
+  }
+  return `0x03${addr.script.hash().slice(2)}`
+}
+
+export async function mint(physicalArtifactNo: string) {
+  // Get address info
+  const address = await ckbfs.getAddress();
+  const ownerHash = await getAddressScriptHash(address)
+  
+  const content = `MINT,TO:${ownerHash}\n`
+
+  // You can provide additional options
+  const options = {
+    contentType: 'text/plain',
+    filename: `${physicalArtifactNo}.LOGS`,
+  };
+  const tx = await ckbfs.createPublishContentTransaction(content, options);
+  const signer = ckbfs['signer']
+  const txHash = await signer.sendTransaction(tx)
+  const ckbfsId = tx.outputs[0].type?.args.toString()
+  return { txHash, log: content, ckbfsId };
+}
+
+export async function claim(to: string, sporeId: string, ckbfsId: string) {
+  const from = await ckbfs.getAddress();
+  const ckbfsCell = await getCkbfsCellInfo(ckbfsId);
+  const fromHash = await getAddressScriptHash(from)
+  const toHash = await getAddressScriptHash(to)
+
+  const content = `TRANSFER,FROM:${fromHash},TO:${toHash}\n`
+
+  let tx = await ckbfs.createAppendContentTransaction(content, ckbfsCell);
+  tx.addCellDeps(TraceLockDep)
+
+  const sizeBefore = tx.outputs[0].lock.occupiedSize
+  const traceLogLock = Script.from({
+    codeHash: TraceLogCodeHash,
+    hashType: "type",
+    args: toHash
+  })
+  tx.outputs[0].lock = traceLogLock
+  const sizeAfter = traceLogLock.occupiedSize
+  
+  const diffSize = BigInt(sizeAfter - sizeBefore) * BigInt(100000000)
+  tx.outputs[0].capacity = tx.outputs[0].capacity + diffSize
+  
+  const sporeLockArgs = `0x01${ tx.outputs[0].type?.hash().slice(2) }`
+  const newSporeLock = Script.from({
+    codeHash: ShadowSporeCodeHash,
+    args: sporeLockArgs,
+    hashType: "data1",
+  })
+
+  tx.outputs = [
+    tx.outputs[0]
+  ]
+
+  const signer = ckbfs['signer'] as any
+  const sporeTx = await transferSpore({
+    signer,
+    id: sporeId,
+    to: newSporeLock,
+    tx: tx,
+  })
+
+  tx.addCellDeps(ShadowDep)
+
+  const finalTx = sporeTx.tx
+  await finalTx.completeFeeBy(signer)
+  const txHash = await signer.sendTransaction(finalTx)
+  console.log(`File appended successfully! Transaction Hash: ${txHash}`);
+  return { txHash, log: content }
+}
+
+export async function giveName(name: string, ckbfsId: string) {
+  const ckbfsCell = await getCkbfsCellInfo(ckbfsId)
+  const content = `GIVE_NAME,NEW_NAME:${name}\n`
+
+  console.log("ckbfsCell=", ckbfsCell)
+  
+  const previousData = {
+    previousTxHash: ckbfsCell.outPoint.txHash,
+    previousWitnessIndex: ckbfsCell.data?.index || 0,
+    previousChecksum: ckbfsCell.data?.checksum || 0
+  };
+  const signer = ckbfs['signer']
+  const address = await signer.getRecommendedAddress()
+  const addressHash = await getAddressScriptHash(address)
+  console.log("addressHash=", addressHash)
+  let tx = await ckbfs.createAppendContentTransaction(content, ckbfsCell, previousData as any);
+  tx.addCellDeps(TestnetTraceLockDep)
+  console.log(tx.stringify())
+  const txHash = await signer.sendTransaction(tx)
+  console.log(`File appended successfully! Transaction Hash: ${txHash}`);
+  return { txHash, log: content }
+}
+
+// export async function transfer(to: string, ckbfsId: string) {
+//   const ckbfsCell = await getCkbfsCellInfo(ckbfsId)
+//   const from = await ckbfs.getAddress();
+//   const fromHash = await getAddressScriptHash(from)
+//   const toHash = await getAddressScriptHash(to)
+//   const content = `TRANSFER,FROM:${fromHash},TO:${toHash}\n`
+  
+//   const signer = ckbfs['signer']
+//   let tx = await ckbfs.createAppendContentTransaction(content, ckbfsCell);
+//   tx.outputs[0].lock.args = toHash as `0x{string}`;
+//   tx.addCellDeps(TestnetTraceLockDep)
+//   const txHash = await signer.sendTransaction(tx)
+//   console.log(`File appended successfully! Transaction Hash: ${txHash}`);
+
+//   return { txHash, log: content };
+// }
+
+// export async function release(from: string, ckbfsId: string) {
+//   const ckbfsCell = await await getCkbfsCellInfo(ckbfsId)
+//   const fromHash = await getAddressScriptHash(from)
+//   const content = `RELEASE,FROM:${fromHash}\n`
+//   const signer = ckbfs['signer']
+//   let tx = await ckbfs.createAppendContentTransaction(content, ckbfsCell);
+ 
+//   tx.addCellDeps(TestnetTraceLockDep)
+//   const txHash = await signer.sendTransaction(tx)
+//   console.log(`File appended successfully! Transaction Hash: ${txHash}`);
+//   return { txHash, log: content };
+// }
+
+// export async function retrieveLogsFromChain(ckbfsId: string) {
+//   const { outPoint, data } = await getCkbfsCellInfo(ckbfsId)
+//   const content = await getFileContentFromChain(client, outPoint, data)
+//   const logs = content.toString().trim().split("\n")
+//   return logs
+// }
+
+export async function getCkbfsCellInfo(ckbfsId: string) {
+  const { codeHash, hashType } = getCKBFSScriptConfig(NetworkType.Testnet, ProtocolVersion.V3)
+  console.log("codeHash, hashType=", codeHash, hashType, ckbfsId)
+  const cell = await client.findSingletonCellByType({
+    codeHash,
+    hashType,
+    args: ckbfsId
+  }, true)
+
+  if (!cell || !cell.cellOutput.type) {
+    throw new Error('No CKBFS cell found');
+  }
+
+  const rawData = cell.outputData.startsWith('0x')
+    ? Buffer.from(cell.outputData.slice(2), 'hex')
+    : Buffer.from(cell.outputData, 'hex');
+
+  const ckbfsData = CKBFSData.unpack(rawData, ProtocolVersion.V3)
+
+  return {
+    outPoint: { txHash: cell.outPoint.txHash as string, index: Number(cell.outPoint.index) },
+    type: cell.cellOutput.type,
+    lock: cell.cellOutput.lock,
+    capacity: cell.cellOutput.capacity,
+    data: ckbfsData,
+  };
+}
+
+
+export function getCkbfsList() {
+  const file = path.join(__dirname, `./data/${'testnet'}/ckbfs-list.json`)
+  return JSON.parse(fs.readFileSync(file).toString())
+}
+
+export async function mintAll() {
+  const ckbfsList = getCkbfsList()
+  for(const { no } of ckbfsList) {
+    const { txHash, ckbfsId } = await mint(no)
+    console.log(`minted ckbfs no=${no}, ckbfsId=${ckbfsId}, txHash=${txHash}`);
+
+    const interval = setInterval(async () => {
+      try {
+        const tx = await client.getTransaction(txHash)
+        if (tx && tx.status === 'committed') {
+          clearInterval(interval)
+          console.info(`tx confirmed, https://explorer.nervos.org/transaction/${txHash}`);
+        }
+      } catch (error) {
+        console.error(error)
+      }
+    }, 5 * 1000)
+  }
+}
+
+async function getCellInfoFromV3Transaction(txHash: string): Promise<{ 
+  outPoint: { txHash: string; index: number };
+  type: Script; 
+  data: CKBFSDataType;
+  lock: Script;
+  capacity: bigint;
+  previousTxHash: string;
+  previousWitnessIndex: number;
+  previousChecksum: number;
+}> {
+  console.log(`Retrieving v3 transaction data for: ${txHash}`);
+  
+  try {
+    // Get transaction from RPC
+    const txWithStatus = await client.getTransaction(txHash);
+    if (!txWithStatus || !txWithStatus.transaction) {
+      throw new Error(`Transaction ${txHash} not found`);
+    }
+    
+    const tx = Transaction.from(txWithStatus.transaction);
+    console.log(`Transaction found with ${tx.outputs.length} outputs`);
+    
+    // Find the CKBFS cell output (first output with type script)
+    let ckbfsCellIndex = 0;
+    const output = tx.outputs[ckbfsCellIndex];
+    if (!output || !output.type) {
+      throw new Error('No CKBFS cell found in the transaction');
+    }
+    
+    console.log(`Found CKBFS v3 cell at index ${ckbfsCellIndex}`);
+    console.log(`Cell type script hash: ${output.type.hash()}`);
+    
+    // Get output data
+    const outputData = tx.outputsData[ckbfsCellIndex];
+    if (!outputData) {
+      throw new Error('Output data not found');
+    }
+    
+    // Parse the output data as CKBFS v3 data
+    const rawData = outputData.startsWith('0x') 
+      ? ccc.bytesFrom(outputData.slice(2), 'hex')
+      : Buffer.from(outputData, 'hex');
+    
+    // Unpack the raw data using v3 format
+    const version = ProtocolVersion.V3;
+    console.log(`Using protocol version ${version} for unpacking v3 cell data`);
+    
+    let ckbfsData: CKBFSDataType;
+    try {
+      ckbfsData = CKBFSData.unpack(rawData, version);
+      
+      console.log('Successfully unpacked CKBFS v3 cell data:');
+      console.log(`- Checksum: ${ckbfsData.checksum}`);
+      console.log(`- File: ${ckbfsData.filename}`);
+      console.log(`- Content Type: ${ckbfsData.contentType}`);
+      console.log(`- Index: ${ckbfsData.index}`);
+    } catch (error) {
+      console.error('Error unpacking CKBFS v3 data:', error);
+      throw new Error(`Failed to unpack CKBFS v3 data: ${error}`);
+    }
+    
+    // Extract backlink information from v3 witness
+    let previousTxHash = '0x' + '00'.repeat(32);
+    let previousWitnessIndex = 0;
+    let previousChecksum = 0;
+    
+    if (ckbfsData.index !== undefined && ckbfsData.index < tx.witnesses.length) {
+      const witnessHex = tx.witnesses[ckbfsData.index];
+      const witness = Buffer.from(witnessHex.slice(2), 'hex');
+      
+      if (isCKBFSV3Witness(witness)) {
+        try {
+          const witnessData = extractCKBFSV3WitnessContent(witness, true);
+          previousTxHash = witnessData.previousTxHash || previousTxHash;
+          previousWitnessIndex = witnessData.previousWitnessIndex || 0;
+          previousChecksum = witnessData.previousChecksum || 0;
+          
+          console.log('Extracted v3 backlink information:');
+          console.log(`- Previous TX Hash: ${previousTxHash}`);
+          console.log(`- Previous Witness Index: ${previousWitnessIndex}`);
+          console.log(`- Previous Checksum: ${previousChecksum}`);
+        } catch (error) {
+          console.warn('Could not extract backlink info from witness:', error);
+        }
+      }
+    }
+    
+    return {
+      outPoint: {
+        txHash,
+        index: ckbfsCellIndex
+      },
+      type: output.type,
+      lock: output.lock,
+      capacity: output.capacity,
+      data: ckbfsData,
+      previousTxHash,
+      previousWitnessIndex,
+      previousChecksum
+    };
+  } catch (error) {
+    console.error('Error retrieving v3 transaction data:', error);
+    throw new Error(`Failed to retrieve or parse v3 cell data: ${error}`);
+  }
+}
+
+async function testReresolve(ckbfsId: string) {
+  const data = (await resolveCKBFSCell(client, ckbfsId, {network:  NetworkType.Testnet}))!
+  return data
+}
+
+// mintAll()
+
+// mint("X30125NMNVAP000201").then(console.log)
+
+// claim("ckt1qyq0zr47f0p8sm5d3cvtlpkljs7zvqcw7ngqnfscx0", "0xa3347c13f0419d9013a3f48a2b9ad993c2b6b5806827f3bf37480a58580d669d", "0x0084106b9bea08f512e35b725c4a710ebf09cb65c05601ebde8d911bc6c662bf")
+
+// getCkbfsCellInfo("0xdb0b0b637060d2f6c42c4429e712fa043c1937968c03c54a5014b4595f88413a").then((data) => {
+//   console.log("ckbfs data=", data)
+//   console.log("mintAll done");
+// })
+
+ //giveName("bbb", "0x0084106b9bea08f512e35b725c4a710ebf09cb65c05601ebde8d911bc6c662bf").then(console.log)
+
+// getCkbfsCellInfo("0x52315569e5ff0d6d6392f047fcbea97bae1b32b688c29aca5251a157157278d3").then((data) => {
+//   console.log("ckbfs data=", data)
+// })
+
+
+getCellInfoFromV3Transaction("0x54c86dbdc6bdafb4616221d54cfc0ff186a4a772eba509838684f8e1ea271b40").then(console.log)
+
+getCkbfsCellInfo("0x2c734e7f72e2e9d1a472f5ba26b229ac319c2ab26fdcd05fd7ce301390875f81").then(console.log)
+
+// testReresolve("0x0084106b9bea08f512e35b725c4a710ebf09cb65c05601ebde8d911bc6c662bf").then(console.log)

package/examples/retrieve-v3.ts

@@ -110,7 +110,7 @@ async function retrieveAndSaveFileV3Example() {
 async function retrieveFileByURIV3Example() {
   try {
     // Example CKBFS URI (replace with actual URI)
-    const ckbfsUri = "ckbfs://d52d8536d3498bd68fa1e235f7e090c2d047154e22fcea5cfa54ccb58c236eb3";
+    const ckbfsUri = "ckbfs://d49b78d821a12da1fc484ef36f855109fc52b195af29cafda1c134656e940a35";
     
     console.log(`Retrieving CKBFS v3 file by URI: ${ckbfsUri}`);
     
@@ -182,6 +182,39 @@ async function retrieveFileByOutPointV3Example() {
   }
 }
 
+async function testReresolve(ckbfsId: string) {
+  const data = (await resolveCKBFSCell(client, ckbfsId, {network: NetworkType.Testnet}))!
+  return data
+}
+
+export async function getCkbfsCellInfo(ckbfsId: string) {
+  const { codeHash, hashType } = getCKBFSScriptConfig(NetworkType.Testnet, ProtocolVersion.V3)
+  console.log("codeHash, hashType=", codeHash, hashType, ckbfsId)
+  const cell = await client.findSingletonCellByType({
+    codeHash,
+    hashType,
+    args: ckbfsId
+  }, true)
+
+  if (!cell || !cell.cellOutput.type) {
+    throw new Error('No CKBFS cell found');
+  }
+
+  const rawData = cell.outputData.startsWith('0x')
+    ? Buffer.from(cell.outputData.slice(2), 'hex')
+    : Buffer.from(cell.outputData, 'hex');
+
+  const ckbfsData = CKBFSData.unpack(rawData, ProtocolVersion.V3)
+
+  return {
+    outPoint: { txHash: cell.outPoint.txHash as string, index: Number(cell.outPoint.index) },
+    type: cell.cellOutput.type,
+    lock: cell.cellOutput.lock,
+    capacity: cell.cellOutput.capacity,
+    data: ckbfsData,
+  };
+}
+
 /**
  * Main function to run the v3 retrieval examples
  */
@@ -196,24 +229,26 @@ async function main() {
   console.log('============================================');
   
   try {
-    console.log('Note: These examples require existing CKBFS v3 files.');
-    console.log('Please run publish-v3.ts first to create v3 files,');
-    console.log('then update the identifiers in this example.');
-    console.log('');
-    console.log('Supported identifier formats:');
-    console.log('- TypeID: 0x1234...abcdef');
-    console.log('- CKBFS URI: ckbfs://1234...abcdef');
-    console.log('- OutPoint URI: ckbfs://1234...abcdefi0');
-    console.log('');
+    // console.log('Note: These examples require existing CKBFS v3 files.');
+    // console.log('Please run publish-v3.ts first to create v3 files,');
+    // console.log('then update the identifiers in this example.');
+    // console.log('');
+    // console.log('Supported identifier formats:');
+    // console.log('- TypeID: 0x1234...abcdef');
+    // console.log('- CKBFS URI: ckbfs://1234...abcdef');
+    // console.log('- OutPoint URI: ckbfs://1234...abcdefi0');
+    // console.log('');
     
     // Uncomment to test different retrieval methods:
     //await retrieveFileByTypeIdV3Example();
     // await retrieveAndSaveFileV3Example();
     await retrieveFileByURIV3Example();
-    //await retrieveFileByOutPointV3Example();
+    // //await retrieveFileByOutPointV3Example();
+
+    // await testReresolve("0x0084106b9bea08f512e35b725c4a710ebf09cb65c05601ebde8d911bc6c662bf").then(console.log)
     
-    console.log('Retrieval example structure completed successfully!');
-    console.log('Update the identifiers and uncomment methods to test.');
+    // console.log('Retrieval example structure completed successfully!');
+    // console.log('Update the identifiers and uncomment methods to test.');
     process.exit(0);
   } catch (error) {
     console.error('CKBFS v3 retrieval examples failed:', error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckbfs/api",
-  "version": "2.0.3",
+  "version": "2.0.5",
   "description": "SDK for CKBFS protocol on CKB",
   "license": "MIT",
   "author": "Code Monad<code@lab-11.org>",
@@ -29,6 +29,7 @@
     "sdk"
   ],
   "devDependencies": {
+    "@ckb-ccc/spore": "^1.5.5",
     "@types/jest": "^29.5.12",
     "@types/node": "^22.7.9",
     "jest": "^29.7.0",

package/src/index.ts

@@ -142,10 +142,6 @@ export type AppendContentOptions = Omit<
   "contentType" | "filename" | "capacity"
 > & { 
   capacity?: bigint;
-  // V3 backlink parameters (optional for backward compatibility)
-  previousTxHash?: string;
-  previousWitnessIndex?: number;
-  previousChecksum?: number;
 };
 
 /**
@@ -475,9 +471,9 @@ export class CKBFS {
 
     // Use V3 when backlink parameters are provided or version is V3
     if (version === ProtocolVersion.V3 && 
-        options.previousTxHash && 
-        options.previousWitnessIndex !== undefined && 
-        options.previousChecksum !== undefined) {
+        ckbfsCell.outPoint.txHash && 
+        ckbfsCell.data.index !== undefined && 
+        ckbfsCell.data.checksum !== undefined) {
       
       const tx = await appendCKBFSV3(this.signer, {
         ckbfsCell,
@@ -485,9 +481,9 @@ export class CKBFS {
         feeRate: options.feeRate,
         network: options.network || this.network,
         version: ProtocolVersion.V3,
-        previousTxHash: options.previousTxHash,
-        previousWitnessIndex: options.previousWitnessIndex,
-        previousChecksum: options.previousChecksum,
+        previousTxHash: ckbfsCell.outPoint.txHash,
+        previousWitnessIndex: ckbfsCell.data.index,
+        previousChecksum: ckbfsCell.data.checksum,
       });
 
       const txHash = await this.signer.sendTransaction(tx);
@@ -708,9 +704,9 @@ export class CKBFS {
 
     // Use V3 when backlink parameters are provided or version is V3
     if (version === ProtocolVersion.V3 && 
-        options.previousTxHash && 
-        options.previousWitnessIndex !== undefined && 
-        options.previousChecksum !== undefined) {
+        ckbfsCell.outPoint.txHash && 
+        ckbfsCell.data.index !== undefined && 
+        ckbfsCell.data.checksum !== undefined) {
       
       return createAppendV3Transaction(this.signer, {
         ckbfsCell,
@@ -718,9 +714,9 @@ export class CKBFS {
         feeRate: options.feeRate,
         network: options.network || this.network,
         version: ProtocolVersion.V3,
-        previousTxHash: options.previousTxHash,
-        previousWitnessIndex: options.previousWitnessIndex,
-        previousChecksum: options.previousChecksum,
+        previousTxHash: ckbfsCell.outPoint.txHash,
+        previousWitnessIndex: ckbfsCell.data.index,
+        previousChecksum: ckbfsCell.data.checksum,
       });
     } else {
       // Legacy V1/V2 behavior or when V3 backlink params are missing

package/src/utils/witness.ts

@@ -208,10 +208,9 @@ export function extractCKBFSV3WitnessContent(witness: Uint8Array, isHeadWitness:
     // Extract previous position
     const prevTxHashBytes = witness.slice(6, 38);
     const previousTxHash = '0x' + Array.from(prevTxHashBytes).map(b => b.toString(16).padStart(2, '0')).join('');
-    
-    const previousWitnessIndex = new DataView(witness.slice(38, 42).buffer).getUint32(0, true);
-    const previousChecksum = new DataView(witness.slice(42, 46).buffer).getUint32(0, true);
-    const nextIndex = new DataView(witness.slice(46, 50).buffer).getUint32(0, true);
+    const previousWitnessIndex = new DataView(witness.slice(38, 42).buffer.slice(witness.slice(38, 42).byteOffset, witness.slice(38, 42).byteOffset + 4)).getUint32(0, true);
+    const previousChecksum = new DataView(witness.slice(42, 46).buffer.slice(witness.slice(42, 46).byteOffset, witness.slice(42, 46).byteOffset + 4)).getUint32(0, true);
+    const nextIndex = new DataView(witness.slice(46, 50).buffer.slice(witness.slice(46, 50).byteOffset, witness.slice(46, 50).byteOffset + 4)).getUint32(0, true);
     const content = witness.slice(50);
     
     return {