@ckbfs/api 2.0.5 → 2.0.7

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/constants.js

@@ -20,6 +20,7 @@ exports.ProtocolVersion = {
 exports.CKBFS_CODE_HASH = {
     [NetworkType.Mainnet]: {
         [exports.ProtocolVersion.V2]: "0x31e6376287d223b8c0410d562fb422f04d1d617b2947596a14c3d2efb7218d3a",
+        [exports.ProtocolVersion.V3]: "0xb5d13ffe0547c78021c01fe24dce2e959a1ed8edbca3cb93dd2e9f57fb56d695",
     },
     [NetworkType.Testnet]: {
         [exports.ProtocolVersion.V1]: "0xe8905ad29a02cf8befa9c258f4f941773839a618d75a64afc22059de9413f712",
@@ -30,6 +31,7 @@ exports.CKBFS_CODE_HASH = {
 exports.CKBFS_TYPE_ID = {
     [NetworkType.Mainnet]: {
         [exports.ProtocolVersion.V2]: "0xfd2058c9a0c0183354cf637e25d2707ffa9bb6fa2ba9b29f4ebc6be3e54ad7eb",
+        [exports.ProtocolVersion.V3]: "0xcc5411e8b70e551d7a3dd806256533cff6bc12118b48dd7b2d5d2292c3651add",
     },
     [NetworkType.Testnet]: {
         [exports.ProtocolVersion.V1]: "0x88ef4d436af35684a27edda0d44dd8771318330285f90f02d13606e095aea86f",
@@ -41,6 +43,7 @@ exports.CKBFS_TYPE_ID = {
 exports.ADLER32_CODE_HASH = {
     [NetworkType.Mainnet]: {
         [exports.ProtocolVersion.V2]: "0x2138683f76944437c0c643664120d620bdb5858dd6c9d1d156805e279c2c536f",
+        [exports.ProtocolVersion.V3]: "0xbd944c8c5aa127270b591d50ab899c9a2a3e4429300db4ea3d7523aa592c1db1",
     },
     [NetworkType.Testnet]: {
         [exports.ProtocolVersion.V1]: "0x8af42cd329cf1bcffb4c73b48252e99cb32346fdbc1cdaa5ae1d000232d47e84",
@@ -51,6 +54,7 @@ exports.ADLER32_CODE_HASH = {
 exports.ADLER32_TYPE_ID = {
     [NetworkType.Mainnet]: {
         [exports.ProtocolVersion.V2]: "0x641c01d590833a3f5471bd441651d9f2a8a200141949cdfeef2d68d8094c5876",
+        [exports.ProtocolVersion.V3]: "0x01b150adbbcba724a3917aefec6453ce4dbf70072d31ad42d0f3429ea32c692b",
     },
     [NetworkType.Testnet]: {
         [exports.ProtocolVersion.V1]: "0xccf29a0d8e860044a3d2f6a6e709f6572f77e4fe245fadd212fc342337048d60",
@@ -62,6 +66,7 @@ exports.ADLER32_TYPE_ID = {
 exports.DEP_GROUP_TX_HASH = {
     [NetworkType.Mainnet]: {
         [exports.ProtocolVersion.V2]: "0xfab07962ed7178ed88d450774e2a6ecd50bae856bdb9b692980be8c5147d1bfa",
+        [exports.ProtocolVersion.V3]: "0x03deba7f8206c81981d6f6a2d61b67dde75b4df91cbcfaf2e2fb041ba50c4719",
     },
     [NetworkType.Testnet]: {
         [exports.ProtocolVersion.V1]: "0xc8fd44aba36f0c4b37536b6c7ea3b88df65fa97e02f77cd33b9bf20bf241a09b",
@@ -76,6 +81,10 @@ exports.DEPLOY_TX_HASH = {
             ckbfs: "0xc9b6698f44c3b80e7e1c48823b2714e432b93f0206ffaf9df885d23267ed2ebc",
             adler32: "0xc9b6698f44c3b80e7e1c48823b2714e432b93f0206ffaf9df885d23267ed2ebc",
         },
+        [exports.ProtocolVersion.V3]: {
+            ckbfs: "0xd25f2c32f56c28c630d4f91955f1b3c9cd53e26fa0745d540d934e8e3d3c2853",
+            adler32: "0xd25f2c32f56c28c630d4f91955f1b3c9cd53e26fa0745d540d934e8e3d3c2853",
+        },
     },
     [NetworkType.Testnet]: {
         [exports.ProtocolVersion.V1]: {

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/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,
@@ -161,19 +164,17 @@ 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()
+  console.log("address=", address)
   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 }
@@ -381,11 +382,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)
@@ -399,8 +401,9 @@ async function testReresolve(ckbfsId: string) {
 // })
 
 
-getCellInfoFromV3Transaction("0x54c86dbdc6bdafb4616221d54cfc0ff186a4a772eba509838684f8e1ea271b40").then(console.log)
+// getCellInfoFromV3Transaction("0x54c86dbdc6bdafb4616221d54cfc0ff186a4a772eba509838684f8e1ea271b40").then(console.log)
 
-getCkbfsCellInfo("0x2c734e7f72e2e9d1a472f5ba26b229ac319c2ab26fdcd05fd7ce301390875f81").then(console.log)
+//getCkbfsCellInfo("0xe58baa82c4844add60911bb890487fea3c45436b9d7b203cc1065301d0a9c503").then(console.log)
+giveName("bbb", "0xe58baa82c4844add60911bb890487fea3c45436b9d7b203cc1065301d0a9c503").then(console.log)
 
 // testReresolve("0x0084106b9bea08f512e35b725c4a710ebf09cb65c05601ebde8d911bc6c662bf").then(console.log)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckbfs/api",
-  "version": "2.0.5",
+  "version": "2.0.7",
   "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/constants.ts

@@ -23,6 +23,8 @@ export const CKBFS_CODE_HASH: Record<NetworkType, Record<string, string>> = {
   [NetworkType.Mainnet]: {
     [ProtocolVersion.V2]:
       "0x31e6376287d223b8c0410d562fb422f04d1d617b2947596a14c3d2efb7218d3a",
+    [ProtocolVersion.V3]:
+      "0xb5d13ffe0547c78021c01fe24dce2e959a1ed8edbca3cb93dd2e9f57fb56d695",
   },
   [NetworkType.Testnet]: {
     [ProtocolVersion.V1]:
@@ -38,6 +40,8 @@ export const CKBFS_TYPE_ID: Record<NetworkType, Record<string, string>> = {
   [NetworkType.Mainnet]: {
     [ProtocolVersion.V2]:
       "0xfd2058c9a0c0183354cf637e25d2707ffa9bb6fa2ba9b29f4ebc6be3e54ad7eb",
+    [ProtocolVersion.V3]:
+      "0xcc5411e8b70e551d7a3dd806256533cff6bc12118b48dd7b2d5d2292c3651add",
   },
   [NetworkType.Testnet]: {
     [ProtocolVersion.V1]:
@@ -54,6 +58,8 @@ export const ADLER32_CODE_HASH: Record<NetworkType, Record<string, string>> = {
   [NetworkType.Mainnet]: {
     [ProtocolVersion.V2]:
       "0x2138683f76944437c0c643664120d620bdb5858dd6c9d1d156805e279c2c536f",
+    [ProtocolVersion.V3]:
+      "0xbd944c8c5aa127270b591d50ab899c9a2a3e4429300db4ea3d7523aa592c1db1",
   },
   [NetworkType.Testnet]: {
     [ProtocolVersion.V1]:
@@ -69,6 +75,8 @@ export const ADLER32_TYPE_ID: Record<NetworkType, Record<string, string>> = {
   [NetworkType.Mainnet]: {
     [ProtocolVersion.V2]:
       "0x641c01d590833a3f5471bd441651d9f2a8a200141949cdfeef2d68d8094c5876",
+    [ProtocolVersion.V3]:
+      "0x01b150adbbcba724a3917aefec6453ce4dbf70072d31ad42d0f3429ea32c692b",
   },
   [NetworkType.Testnet]: {
     [ProtocolVersion.V1]:
@@ -85,6 +93,8 @@ export const DEP_GROUP_TX_HASH: Record<NetworkType, Record<string, string>> = {
   [NetworkType.Mainnet]: {
     [ProtocolVersion.V2]:
       "0xfab07962ed7178ed88d450774e2a6ecd50bae856bdb9b692980be8c5147d1bfa",
+    [ProtocolVersion.V3]:
+      "0x03deba7f8206c81981d6f6a2d61b67dde75b4df91cbcfaf2e2fb041ba50c4719",
   },
   [NetworkType.Testnet]: {
     [ProtocolVersion.V1]:
@@ -108,6 +118,12 @@ export const DEPLOY_TX_HASH: Record<
       adler32:
         "0xc9b6698f44c3b80e7e1c48823b2714e432b93f0206ffaf9df885d23267ed2ebc",
     },
+    [ProtocolVersion.V3]: {
+      ckbfs:
+        "0xd25f2c32f56c28c630d4f91955f1b3c9cd53e26fa0745d540d934e8e3d3c2853",
+      adler32:
+        "0xd25f2c32f56c28c630d4f91955f1b3c9cd53e26fa0745d540d934e8e3d3c2853",
+    },
   },
   [NetworkType.Testnet]: {
     [ProtocolVersion.V1]: {

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()) {