@ckbfs/api 2.0.4 → 2.0.6

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 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 { createCKBFSCell, createPublishTransaction as utilCreatePublishTransaction, preparePublishTransaction, createAppendTransaction as utilCreateAppendTransaction, prepareAppendTransaction, createAppendTransactionDry, publishCKBFS as utilPublishCKBFS, appendCKBFS as utilAppendCKBFS, CKBFSCellOptions, PublishOptions, AppendOptions, AppendV3Options, TransferV3Options, createAppendV3Transaction } 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, 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";
@@ -28,6 +28,7 @@ export type PublishContentOptions = Omit<FileOptions, "capacity" | "contentType"
  */
 export type AppendContentOptions = Omit<FileOptions, "contentType" | "filename" | "capacity"> & {
     capacity?: bigint;
+    witnessStartIndex?: number;
 };
 /**
  * Configuration options for the CKBFS SDK
@@ -96,6 +97,7 @@ export declare class CKBFS {
         previousTxHash?: string;
         previousWitnessIndex?: number;
         previousChecksum?: number;
+        witnessStartIndex?: number;
     }): Promise<string>;
     /**
      * Appends content (string or Uint8Array) directly to an existing CKBFS file
@@ -130,6 +132,7 @@ export declare class CKBFS {
         previousTxHash?: string;
         previousWitnessIndex?: number;
         previousChecksum?: number;
+        witnessStartIndex?: number;
     }): Promise<Transaction>;
     /**
      * Creates a new transaction for appending content (string or Uint8Array) directly, but doesn't sign or send it
@@ -194,4 +197,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, 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, };
+export { calculateChecksum, verifyChecksum, updateChecksum, verifyWitnessChecksum, verifyV3WitnessChecksum, verifyV3WitnessChain, createCKBFSCell, utilCreatePublishTransaction as createPublishTransaction, preparePublishTransaction, utilCreateAppendTransaction as createAppendTransaction, prepareAppendTransaction, utilPublishCKBFS as publishCKBFS, utilAppendCKBFS as appendCKBFS, createAppendTransactionDry, createAppendV3Transaction, 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.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;
+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.createAppendV3Transaction = 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 = exports.resolveCKBFSCell = 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; } });
@@ -19,6 +19,7 @@ Object.defineProperty(exports, "prepareAppendTransaction", { enumerable: true, g
 Object.defineProperty(exports, "createAppendTransactionDry", { enumerable: true, get: function () { return transaction_1.createAppendTransactionDry; } });
 Object.defineProperty(exports, "publishCKBFS", { enumerable: true, get: function () { return transaction_1.publishCKBFS; } });
 Object.defineProperty(exports, "appendCKBFS", { enumerable: true, get: function () { return transaction_1.appendCKBFS; } });
+Object.defineProperty(exports, "createAppendV3Transaction", { enumerable: true, get: function () { return transaction_1.createAppendV3Transaction; } });
 const file_1 = require("./utils/file");
 Object.defineProperty(exports, "readFile", { enumerable: true, get: function () { return file_1.readFile; } });
 Object.defineProperty(exports, "readFileAsText", { enumerable: true, get: function () { return file_1.readFileAsText; } });
@@ -478,6 +479,7 @@ class CKBFS {
                 previousTxHash: options.previousTxHash,
                 previousWitnessIndex: options.previousWitnessIndex,
                 previousChecksum: options.previousChecksum,
+                witnessStartIndex: options.witnessStartIndex,
             });
         }
         else {

package/dist/utils/transactions/shared.d.ts

@@ -49,6 +49,7 @@ export interface BaseAppendOptions {
     network?: NetworkType;
     version?: ProtocolVersionType;
     from?: Transaction;
+    witnessStartIndex?: number;
 }
 /**
  * Common CKBFS cell creation options

package/dist/utils/transactions/v3.d.ts

@@ -33,6 +33,7 @@ export interface AppendV3Options {
     network?: NetworkType;
     version: typeof ProtocolVersion.V3;
     from?: Transaction;
+    witnessStartIndex?: number;
     previousTxHash: string;
     previousWitnessIndex: number;
     previousChecksum: number;

package/dist/utils/transactions/v3.js

@@ -217,12 +217,12 @@ async function createPublishV3Transaction(signer, options) {
  * @returns Promise resolving to the prepared transaction and the output index of CKBFS Cell
  */
 async function prepareAppendV3Transaction(options) {
-    const { from, ckbfsCell, contentChunks, network = constants_1.DEFAULT_NETWORK, previousTxHash, previousWitnessIndex, previousChecksum, } = options;
+    const { from, ckbfsCell, contentChunks, network = constants_1.DEFAULT_NETWORK, previousTxHash, previousWitnessIndex, previousChecksum, witnessStartIndex, } = options;
     // Calculate new checksum by updating from previous checksum
     const combinedContent = Buffer.concat(contentChunks);
     const newChecksum = await (0, checksum_1.updateChecksum)(previousChecksum, combinedContent);
     // Calculate the actual witness indices where our content is placed
-    const contentStartIndex = from?.witnesses.length || 1;
+    const contentStartIndex = witnessStartIndex || from?.witnesses.length || 0;
     // Create CKBFS v3 witnesses with backlink info
     const ckbfsWitnesses = (0, witness_1.createChunkedCKBFSV3Witnesses)(contentChunks, {
         previousTxHash,
@@ -350,6 +350,7 @@ async function createAppendV3Transaction(signer, options) {
         // Add more inputs to cover the increased capacity
         await preTx.completeInputsByCapacity(signer);
     }
+    await preTx.completeInputsByCapacity(signer);
     const witnesses = [];
     // add empty witness for signer if ckbfs's lock is the same as signer's lock
     if (address.script.hash() === lock.hash()) {

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

@@ -18,7 +18,10 @@ import {
   ClientPublicTestnet, 
   ClientPublicMainnet, 
   Transaction,
-  ccc
+  ccc,
+  SignerCkbPrivateKey,
+  fixedPointFrom,
+  Signer
 } from "@ckb-ccc/core";
 import { 
   transferSpore
@@ -30,7 +33,7 @@ const client = new ClientPublicTestnet()
 
 export const TestnetTraceLockDep = {
   outPoint: {
-    txHash: "0xf6d5b0c8c5221cc9d158fd8556a3772c25a295b9f894eeb86291a25522cf90b0",
+    txHash: "0x7a3e492188438ca4b260fed0f7a00d18ec9e4671a8c3b54fc2b3b49447ab2e2f",
     index: 0x0,
   },
   depType: "code",
@@ -66,7 +69,7 @@ const ShadowDep = TestnetShadowDep
 
 const TraceLogCodeHash = "0xbd7e56daaa4cc9ecf488a50d2f4db2a55a7c86eb2df2157d24a62be9be5b34ab"
 const ShadowSporeCodeHash = "0x6361d4b20d845953d9c9431bbba08905573005a71e2a2432e7e0e7c685666f24"
-const CKB_PRIVATE_KEY = "0x1733e6f7825f99eb41ca26f8569fa90c2cb8c5ae199bbd38a97562291f784983"
+const CKB_PRIVATE_KEY = "0x620ab1e4273b937032380e9f851c3119427ba965805bebcdce60a4494fd3074d"
 
 const ckbfs = new CKBFS(
   CKB_PRIVATE_KEY,
@@ -113,13 +116,7 @@ export async function claim(to: string, sporeId: string, ckbfsId: string) {
 
   const content = `TRANSFER,FROM:${fromHash},TO:${toHash}\n`
 
-  const previousData = {
-    previousTxHash: ckbfsCell.outPoint.txHash,
-    previousWitnessIndex: ckbfsCell.data?.index || 0,
-    previousChecksum: ckbfsCell.data?.checksum || 0
-  };
-
-  let tx = await ckbfs.createAppendContentTransaction(content, ckbfsCell, previousData as any);
+  let tx = await ckbfs.createAppendContentTransaction(content, ckbfsCell);
   tx.addCellDeps(TraceLockDep)
 
   const sizeBefore = tx.outputs[0].lock.occupiedSize
@@ -167,19 +164,16 @@ export async function giveName(name: string, ckbfsId: string) {
   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);
+  let tx = await ckbfs.createAppendContentTransaction(content, ckbfsCell, {
+    witnessStartIndex: 1,
+  });
   tx.addCellDeps(TestnetTraceLockDep)
-  console.log(tx.stringify())
+  // console.log("tx=", JSON.stringify(JSON.parse(tx.stringify()), null, 2))
   const txHash = await signer.sendTransaction(tx)
   console.log(`File appended successfully! Transaction Hash: ${txHash}`);
   return { txHash, log: content }
@@ -387,11 +381,12 @@ async function testReresolve(ckbfsId: string) {
   return data
 }
 
+
 // mintAll()
 
-// mint("X30125NMNVAP000201").then(console.log)
+//mint("X30125NMNVAP000201").then(console.log)
 
-// claim("ckt1qyq0zr47f0p8sm5d3cvtlpkljs7zvqcw7ngqnfscx0", "0xa3347c13f0419d9013a3f48a2b9ad993c2b6b5806827f3bf37480a58580d669d", "0x0084106b9bea08f512e35b725c4a710ebf09cb65c05601ebde8d911bc6c662bf")
+//claim("ckt1qyq0zr47f0p8sm5d3cvtlpkljs7zvqcw7ngqnfscx0", "0xa3347c13f0419d9013a3f48a2b9ad993c2b6b5806827f3bf37480a58580d669d", "0x0084106b9bea08f512e35b725c4a710ebf09cb65c05601ebde8d911bc6c662bf")
 
 // getCkbfsCellInfo("0xdb0b0b637060d2f6c42c4429e712fa043c1937968c03c54a5014b4595f88413a").then((data) => {
 //   console.log("ckbfs data=", data)
@@ -405,8 +400,9 @@ async function testReresolve(ckbfsId: string) {
 // })
 
 
-// getCellInfoFromV3Transaction("0x8dc79a7630145e2a220e2363beca2781c6a4f0f79ef7a01ab73f17dc90571fb7").then(console.log)
+// getCellInfoFromV3Transaction("0x54c86dbdc6bdafb4616221d54cfc0ff186a4a772eba509838684f8e1ea271b40").then(console.log)
 
-// getCkbfsCellInfo("0x0084106b9bea08f512e35b725c4a710ebf09cb65c05601ebde8d911bc6c662bf").then(console.log)
+//getCkbfsCellInfo("0xe58baa82c4844add60911bb890487fea3c45436b9d7b203cc1065301d0a9c503").then(console.log)
+giveName("bbb", "0xe58baa82c4844add60911bb890487fea3c45436b9d7b203cc1065301d0a9c503").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}`);
     
@@ -242,10 +242,10 @@ async function main() {
     // Uncomment to test different retrieval methods:
     //await retrieveFileByTypeIdV3Example();
     // await retrieveAndSaveFileV3Example();
-    // await retrieveFileByURIV3Example();
+    await retrieveFileByURIV3Example();
     // //await retrieveFileByOutPointV3Example();
 
-    await testReresolve("0x0084106b9bea08f512e35b725c4a710ebf09cb65c05601ebde8d911bc6c662bf").then(console.log)
+    // await testReresolve("0x0084106b9bea08f512e35b725c4a710ebf09cb65c05601ebde8d911bc6c662bf").then(console.log)
     
     // console.log('Retrieval example structure completed successfully!');
     // console.log('Update the identifiers and uncomment methods to test.');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckbfs/api",
-  "version": "2.0.4",
+  "version": "2.0.6",
   "description": "SDK for CKBFS protocol on CKB",
   "license": "MIT",
   "author": "Code Monad<code@lab-11.org>",

package/src/index.ts

@@ -142,6 +142,7 @@ export type AppendContentOptions = Omit<
   "contentType" | "filename" | "capacity"
 > & { 
   capacity?: bigint;
+  witnessStartIndex?: number;
 };
 
 /**
@@ -395,6 +396,7 @@ export class CKBFS {
       previousTxHash?: string;
       previousWitnessIndex?: number;
       previousChecksum?: number;
+      witnessStartIndex?: number;
     } = {},
   ): Promise<string> {
     // Read the file and split into chunks
@@ -638,6 +640,7 @@ export class CKBFS {
       previousTxHash?: string;
       previousWitnessIndex?: number;
       previousChecksum?: number;
+      witnessStartIndex?: number;
     } = {},
   ): Promise<Transaction> {
     // Read the file and split into chunks
@@ -666,6 +669,7 @@ export class CKBFS {
         previousTxHash: options.previousTxHash,
         previousWitnessIndex: options.previousWitnessIndex,
         previousChecksum: options.previousChecksum,
+        witnessStartIndex: options.witnessStartIndex,
       });
     } else {
       // Legacy V1/V2 behavior or when V3 backlink params are missing
@@ -1005,6 +1009,7 @@ export {
   utilPublishCKBFS as publishCKBFS,
   utilAppendCKBFS as appendCKBFS,
   createAppendTransactionDry,
+  createAppendV3Transaction,
   // File utilities
   readFile,
   readFileAsText,

package/src/utils/transactions/shared.ts

@@ -56,6 +56,7 @@ export interface BaseAppendOptions {
   network?: NetworkType;
   version?: ProtocolVersionType;
   from?: Transaction;
+  witnessStartIndex?: number;
 }
 
 /**

package/src/utils/transactions/v1v2.ts

@@ -29,7 +29,8 @@ export interface PublishOptions extends BasePublishOptions {}
 /**
  * Options for appending content to a CKBFS file (V1/V2)
  */
-export interface AppendOptions extends BaseAppendOptions {}
+export interface AppendOptions extends BaseAppendOptions {
+}
 
 /**
  * Creates a CKBFS cell

package/src/utils/transactions/v3.ts

@@ -1,6 +1,6 @@
 import { ccc, Transaction, Script, Signer } from "@ckb-ccc/core";
 import { calculateChecksum, updateChecksum } from "../checksum";
-import { CKBFSData, CKBFSDataType } from "../molecule";
+import { CKBFSData, CKBFSDataType, CKBFSDataV3 } from "../molecule";
 import { createChunkedCKBFSV3Witnesses, CKBFSV3WitnessOptions } from "../witness";
 import {
   getCKBFSScriptConfig,
@@ -45,6 +45,7 @@ export interface AppendV3Options {
   network?: NetworkType;
   version: typeof ProtocolVersion.V3;
   from?: Transaction;
+  witnessStartIndex?: number;
   previousTxHash: string;
   previousWitnessIndex: number;
   previousChecksum: number;
@@ -357,6 +358,7 @@ export async function prepareAppendV3Transaction(
     previousTxHash,
     previousWitnessIndex,
     previousChecksum,
+    witnessStartIndex,
   } = options;
 
   // Calculate new checksum by updating from previous checksum
@@ -364,7 +366,7 @@ export async function prepareAppendV3Transaction(
   const newChecksum = await updateChecksum(previousChecksum, combinedContent);
 
   // Calculate the actual witness indices where our content is placed
-  const contentStartIndex = from?.witnesses.length || 1;
+  const contentStartIndex = witnessStartIndex || from?.witnesses.length || 0;
 
   // Create CKBFS v3 witnesses with backlink info
   const ckbfsWitnesses = createChunkedCKBFSV3Witnesses(contentChunks, {
@@ -517,6 +519,8 @@ export async function createAppendV3Transaction(
     await preTx.completeInputsByCapacity(signer);
   }
 
+  await preTx.completeInputsByCapacity(signer);
+
   const witnesses: any = [];
   // add empty witness for signer if ckbfs's lock is the same as signer's lock
   if (address.script.hash() === lock.hash()) {

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 {