@ckbfs/api 1.5.1 → 2.0.1

package/dist/index.js

@@ -1,13 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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.createChunkedCKBFSWitnesses = exports.isCKBFSWitness = exports.extractCKBFSWitnessContent = exports.createTextCKBFSWitness = exports.createCKBFSWitness = 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.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 = void 0;
+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;
 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; } });
 Object.defineProperty(exports, "verifyChecksum", { enumerable: true, get: function () { return checksum_1.verifyChecksum; } });
 Object.defineProperty(exports, "updateChecksum", { enumerable: true, get: function () { return checksum_1.updateChecksum; } });
 Object.defineProperty(exports, "verifyWitnessChecksum", { enumerable: true, get: function () { return checksum_1.verifyWitnessChecksum; } });
+Object.defineProperty(exports, "verifyV3WitnessChecksum", { enumerable: true, get: function () { return checksum_1.verifyV3WitnessChecksum; } });
+Object.defineProperty(exports, "verifyV3WitnessChain", { enumerable: true, get: function () { return checksum_1.verifyV3WitnessChain; } });
 const transaction_1 = require("./utils/transaction");
 Object.defineProperty(exports, "createCKBFSCell", { enumerable: true, get: function () { return transaction_1.createCKBFSCell; } });
 Object.defineProperty(exports, "createPublishTransaction", { enumerable: true, get: function () { return transaction_1.createPublishTransaction; } });
@@ -40,12 +42,21 @@ Object.defineProperty(exports, "decodeMultipleWitnessContents", { enumerable: tr
 Object.defineProperty(exports, "extractFileFromWitnesses", { enumerable: true, get: function () { return file_1.extractFileFromWitnesses; } });
 Object.defineProperty(exports, "decodeFileFromWitnessData", { enumerable: true, get: function () { return file_1.decodeFileFromWitnessData; } });
 Object.defineProperty(exports, "saveFileFromWitnessData", { enumerable: true, get: function () { return file_1.saveFileFromWitnessData; } });
+Object.defineProperty(exports, "getFileContentFromChainV3", { enumerable: true, get: function () { return 
+    // V3 file retrieval functions
+    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; } });
 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; } });
 Object.defineProperty(exports, "extractCKBFSWitnessContent", { enumerable: true, get: function () { return witness_1.extractCKBFSWitnessContent; } });
 Object.defineProperty(exports, "isCKBFSWitness", { enumerable: true, get: function () { return witness_1.isCKBFSWitness; } });
 Object.defineProperty(exports, "createChunkedCKBFSWitnesses", { enumerable: true, get: function () { return witness_1.createChunkedCKBFSWitnesses; } });
+Object.defineProperty(exports, "createCKBFSV3Witness", { enumerable: true, get: function () { return witness_1.createCKBFSV3Witness; } });
+Object.defineProperty(exports, "createChunkedCKBFSV3Witnesses", { enumerable: true, get: function () { return witness_1.createChunkedCKBFSV3Witnesses; } });
+Object.defineProperty(exports, "extractCKBFSV3WitnessContent", { enumerable: true, get: function () { return witness_1.extractCKBFSV3WitnessContent; } });
+Object.defineProperty(exports, "isCKBFSV3Witness", { enumerable: true, get: function () { return witness_1.isCKBFSV3Witness; } });
 const molecule_1 = require("./utils/molecule");
 Object.defineProperty(exports, "CKBFSData", { enumerable: true, get: function () { return molecule_1.CKBFSData; } });
 Object.defineProperty(exports, "BackLinkV1", { enumerable: true, get: function () { return molecule_1.BackLinkV1; } });
@@ -154,22 +165,44 @@ class CKBFS {
         // Use the filename from the path if not provided
         const pathParts = filePath.split(/[\\\/]/);
         const filename = options.filename || pathParts[pathParts.length - 1];
-        // Create and sign the transaction using the utility function
-        const tx = await (0, transaction_1.publishCKBFS)(this.signer, {
-            contentChunks,
-            contentType,
-            filename,
-            lock,
-            capacity: options.capacity,
-            feeRate: options.feeRate,
-            network: options.network || this.network,
-            version: options.version || this.version,
-            useTypeID: options.useTypeID !== undefined ? options.useTypeID : this.useTypeID,
-        });
-        console.log("Publish file tx:", tx.stringify());
-        // Send the transaction
-        const txHash = await this.signer.sendTransaction(tx);
-        return (0, transaction_2.ensureHexPrefix)(txHash);
+        // Determine version - default to V3, allow override
+        const version = options.version || this.version;
+        // Use V3 by default, fallback to legacy for older versions
+        if (version === constants_1.ProtocolVersion.V3) {
+            const tx = await (0, transaction_1.publishCKBFSV3)(this.signer, {
+                contentChunks,
+                contentType,
+                filename,
+                lock,
+                capacity: options.capacity,
+                feeRate: options.feeRate,
+                network: options.network || this.network,
+                useTypeID: options.useTypeID !== undefined ? options.useTypeID : this.useTypeID,
+                version: constants_1.ProtocolVersion.V3,
+            });
+            console.log("Publish file tx:", tx.stringify());
+            // Send the transaction
+            const txHash = await this.signer.sendTransaction(tx);
+            return (0, transaction_2.ensureHexPrefix)(txHash);
+        }
+        else {
+            // Legacy V1/V2 behavior
+            const tx = await (0, transaction_1.publishCKBFS)(this.signer, {
+                contentChunks,
+                contentType,
+                filename,
+                lock,
+                capacity: options.capacity,
+                feeRate: options.feeRate,
+                network: options.network || this.network,
+                version,
+                useTypeID: options.useTypeID !== undefined ? options.useTypeID : this.useTypeID,
+            });
+            console.log("Publish file tx:", tx.stringify());
+            // Send the transaction
+            const txHash = await this.signer.sendTransaction(tx);
+            return (0, transaction_2.ensureHexPrefix)(txHash);
+        }
     }
     /**
      * Publishes content (string or Uint8Array) directly to CKBFS
@@ -186,20 +219,40 @@ class CKBFS {
         const lock = await this.getLock();
         // Use provided contentType and filename (required)
         const { contentType, filename } = options;
-        const tx = await (0, transaction_1.publishCKBFS)(this.signer, {
-            contentChunks,
-            contentType,
-            filename,
-            lock,
-            capacity: options.capacity,
-            feeRate: options.feeRate,
-            network: options.network || this.network,
-            version: options.version || this.version,
-            useTypeID: options.useTypeID !== undefined ? options.useTypeID : this.useTypeID,
-        });
-        console.log("Publish content tx:", tx.stringify());
-        const txHash = await this.signer.sendTransaction(tx);
-        return (0, transaction_2.ensureHexPrefix)(txHash);
+        // Determine version - default to V3, allow override
+        const version = options.version || this.version;
+        // Use V3 by default, fallback to legacy for older versions
+        if (version === constants_1.ProtocolVersion.V3) {
+            const tx = await (0, transaction_1.publishCKBFSV3)(this.signer, {
+                contentChunks,
+                contentType,
+                filename,
+                lock,
+                capacity: options.capacity,
+                feeRate: options.feeRate,
+                network: options.network || this.network,
+                useTypeID: options.useTypeID !== undefined ? options.useTypeID : this.useTypeID,
+                version: constants_1.ProtocolVersion.V3,
+            });
+            const txHash = await this.signer.sendTransaction(tx);
+            return (0, transaction_2.ensureHexPrefix)(txHash);
+        }
+        else {
+            // Legacy V1/V2 behavior
+            const tx = await (0, transaction_1.publishCKBFS)(this.signer, {
+                contentChunks,
+                contentType,
+                filename,
+                lock,
+                capacity: options.capacity,
+                feeRate: options.feeRate,
+                network: options.network || this.network,
+                version,
+                useTypeID: options.useTypeID !== undefined ? options.useTypeID : this.useTypeID,
+            });
+            const txHash = await this.signer.sendTransaction(tx);
+            return (0, transaction_2.ensureHexPrefix)(txHash);
+        }
     }
     /**
      * Appends content from a file to an existing CKBFS file
@@ -215,18 +268,40 @@ class CKBFS {
         for (let i = 0; i < fileContent.length; i += this.chunkSize) {
             contentChunks.push(fileContent.slice(i, i + this.chunkSize));
         }
-        // Create and sign the transaction using the utility function
-        const tx = await (0, transaction_1.appendCKBFS)(this.signer, {
-            ckbfsCell,
-            contentChunks,
-            feeRate: options.feeRate,
-            network: options.network || this.network,
-            version: options.version || this.version,
-        });
-        console.log("Append file tx:", tx.stringify());
-        // Send the transaction
-        const txHash = await this.signer.sendTransaction(tx);
-        return (0, transaction_2.ensureHexPrefix)(txHash);
+        // Determine version - default to V3, allow override
+        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) {
+            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,
+            });
+            console.log("Append file v3 tx:", tx.stringify());
+            const txHash = await this.signer.sendTransaction(tx);
+            return (0, transaction_2.ensureHexPrefix)(txHash);
+        }
+        else {
+            // Legacy V1/V2 behavior or when V3 backlink params are missing
+            const tx = await (0, transaction_1.appendCKBFS)(this.signer, {
+                ckbfsCell,
+                contentChunks,
+                feeRate: options.feeRate,
+                network: options.network || this.network,
+                version: version === constants_1.ProtocolVersion.V3 ? constants_1.ProtocolVersion.V2 : version, // Fallback to V2 if V3 but missing backlink params
+            });
+            console.log("Append file tx:", tx.stringify());
+            const txHash = await this.signer.sendTransaction(tx);
+            return (0, transaction_2.ensureHexPrefix)(txHash);
+        }
     }
     /**
      * Appends content (string or Uint8Array) directly to an existing CKBFS file
@@ -241,17 +316,39 @@ class CKBFS {
         for (let i = 0; i < contentBytes.length; i += this.chunkSize) {
             contentChunks.push(contentBytes.slice(i, i + this.chunkSize));
         }
-        const tx = await (0, transaction_1.appendCKBFS)(this.signer, {
-            ckbfsCell,
-            contentChunks,
-            feeRate: options.feeRate,
-            network: options.network || this.network,
-            version: options.version || this.version,
-            // No useTypeID option for append
-        });
-        console.log("Append content tx:", tx.stringify());
-        const txHash = await this.signer.sendTransaction(tx);
-        return (0, transaction_2.ensureHexPrefix)(txHash);
+        // Determine version - default to V3, allow override
+        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) {
+            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,
+            });
+            const txHash = await this.signer.sendTransaction(tx);
+            return (0, transaction_2.ensureHexPrefix)(txHash);
+        }
+        else {
+            // Legacy V1/V2 behavior or when V3 backlink params are missing
+            const tx = await (0, transaction_1.appendCKBFS)(this.signer, {
+                ckbfsCell,
+                contentChunks,
+                feeRate: options.feeRate,
+                network: options.network || this.network,
+                version: version === constants_1.ProtocolVersion.V3 ? constants_1.ProtocolVersion.V2 : version, // Fallback to V2 if V3 but missing backlink params
+                // No useTypeID option for append
+            });
+            const txHash = await this.signer.sendTransaction(tx);
+            return (0, transaction_2.ensureHexPrefix)(txHash);
+        }
     }
     /**
      * Creates a new transaction for publishing a file but doesn't sign or send it
@@ -273,8 +370,192 @@ class CKBFS {
         // Use the filename from the path if not provided
         const pathParts = filePath.split(/[\\\/]/);
         const filename = options.filename || pathParts[pathParts.length - 1];
-        // Create the transaction using the utility function
-        return (0, transaction_1.createPublishTransaction)(this.signer, {
+        // Determine version - default to V3, allow override
+        const version = options.version || this.version;
+        // Use V3 by default, fallback to legacy for older versions
+        if (version === constants_1.ProtocolVersion.V3) {
+            return (0, transaction_1.createPublishV3Transaction)(this.signer, {
+                contentChunks,
+                contentType,
+                filename,
+                lock,
+                capacity: options.capacity,
+                feeRate: options.feeRate,
+                network: options.network || this.network,
+                useTypeID: options.useTypeID !== undefined ? options.useTypeID : this.useTypeID,
+                version: constants_1.ProtocolVersion.V3,
+            });
+        }
+        else {
+            // Legacy V1/V2 behavior
+            return (0, transaction_1.createPublishTransaction)(this.signer, {
+                contentChunks,
+                contentType,
+                filename,
+                lock,
+                capacity: options.capacity,
+                feeRate: options.feeRate,
+                network: options.network || this.network,
+                version,
+                useTypeID: options.useTypeID !== undefined ? options.useTypeID : this.useTypeID,
+            });
+        }
+    }
+    /**
+     * Creates a new transaction for publishing content (string or Uint8Array) directly, but doesn't sign or send it
+     * @param content The content string or byte array to publish
+     * @param options Options for publishing the content (contentType and filename are required)
+     * @returns Promise resolving to the unsigned transaction
+     */
+    async createPublishContentTransaction(content, options) {
+        const contentBytes = typeof content === "string" ? textEncoder.encode(content) : content;
+        const contentChunks = [];
+        for (let i = 0; i < contentBytes.length; i += this.chunkSize) {
+            contentChunks.push(contentBytes.slice(i, i + this.chunkSize));
+        }
+        const lock = await this.getLock();
+        // Use provided contentType and filename (required)
+        const { contentType, filename } = options;
+        // Determine version - default to V3, allow override
+        const version = options.version || this.version;
+        // Use V3 by default, fallback to legacy for older versions
+        if (version === constants_1.ProtocolVersion.V3) {
+            return (0, transaction_1.createPublishV3Transaction)(this.signer, {
+                contentChunks,
+                contentType,
+                filename,
+                lock,
+                capacity: options.capacity,
+                feeRate: options.feeRate,
+                network: options.network || this.network,
+                useTypeID: options.useTypeID !== undefined ? options.useTypeID : this.useTypeID,
+                version: constants_1.ProtocolVersion.V3,
+            });
+        }
+        else {
+            // Legacy V1/V2 behavior
+            return (0, transaction_1.createPublishTransaction)(this.signer, {
+                contentChunks,
+                contentType,
+                filename,
+                lock,
+                capacity: options.capacity,
+                feeRate: options.feeRate,
+                network: options.network || this.network,
+                version,
+                useTypeID: options.useTypeID !== undefined ? options.useTypeID : this.useTypeID,
+            });
+        }
+    }
+    /**
+     * Creates a new transaction for appending content from a file but doesn't sign or send it
+     * @param filePath The path to the file containing the content to append
+     * @param ckbfsCell The CKBFS cell to append to
+     * @param options Additional options for the append operation
+     * @returns Promise resolving to the unsigned transaction
+     */
+    async createAppendTransaction(filePath, ckbfsCell, options = {}) {
+        // Read the file and split into chunks
+        const fileContent = (0, file_1.readFileAsUint8Array)(filePath);
+        const contentChunks = [];
+        for (let i = 0; i < fileContent.length; i += this.chunkSize) {
+            contentChunks.push(fileContent.slice(i, i + this.chunkSize));
+        }
+        // Determine version - default to V3, allow override
+        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) {
+            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,
+            });
+        }
+        else {
+            // Legacy V1/V2 behavior or when V3 backlink params are missing
+            return (0, transaction_1.createAppendTransaction)(this.signer, {
+                ckbfsCell,
+                contentChunks,
+                feeRate: options.feeRate,
+                network: options.network || this.network,
+                version: version === constants_1.ProtocolVersion.V3 ? constants_1.ProtocolVersion.V2 : version, // Fallback to V2 if V3 but missing backlink params
+            });
+        }
+    }
+    /**
+     * Creates a new transaction for appending content (string or Uint8Array) directly, but doesn't sign or send it
+     * @param content The content string or byte array to append
+     * @param ckbfsCell The CKBFS cell to append to
+     * @param options Additional options for the append operation
+     * @returns Promise resolving to the unsigned transaction
+     */
+    async createAppendContentTransaction(content, ckbfsCell, options = {}) {
+        const contentBytes = typeof content === "string" ? textEncoder.encode(content) : content;
+        const contentChunks = [];
+        for (let i = 0; i < contentBytes.length; i += this.chunkSize) {
+            contentChunks.push(contentBytes.slice(i, i + this.chunkSize));
+        }
+        // Determine version - default to V3, allow override
+        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) {
+            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,
+            });
+        }
+        else {
+            // Legacy V1/V2 behavior or when V3 backlink params are missing
+            return (0, transaction_1.createAppendTransaction)(this.signer, {
+                ckbfsCell,
+                contentChunks,
+                feeRate: options.feeRate,
+                network: options.network || this.network,
+                version: version === constants_1.ProtocolVersion.V3 ? constants_1.ProtocolVersion.V2 : version, // Fallback to V2 if V3 but missing backlink params
+                // No useTypeID option for append
+            });
+        }
+    }
+    // V3 Methods
+    /**
+     * Publishes a file to CKBFS v3
+     * @param filePath The path to the file to publish
+     * @param options Options for publishing the file
+     * @returns Promise resolving to the transaction hash
+     */
+    async publishFileV3(filePath, options = {}) {
+        // Read the file and split into chunks
+        const fileContent = (0, file_1.readFileAsUint8Array)(filePath);
+        const contentChunks = [];
+        for (let i = 0; i < fileContent.length; i += this.chunkSize) {
+            contentChunks.push(fileContent.slice(i, i + this.chunkSize));
+        }
+        // Get the lock script
+        const lock = await this.getLock();
+        // Determine content type if not provided
+        const contentType = options.contentType || (0, file_1.getContentType)(filePath);
+        // Use the filename from the path if not provided
+        const pathParts = filePath.split(/[\\\/]/);
+        const filename = options.filename || pathParts[pathParts.length - 1];
+        // Create and sign the transaction using the v3 utility function
+        const tx = await (0, transaction_1.publishCKBFSV3)(this.signer, {
             contentChunks,
             contentType,
             filename,
@@ -282,17 +563,21 @@ class CKBFS {
             capacity: options.capacity,
             feeRate: options.feeRate,
             network: options.network || this.network,
-            version: options.version || this.version,
             useTypeID: options.useTypeID !== undefined ? options.useTypeID : this.useTypeID,
+            version: constants_1.ProtocolVersion.V3,
         });
+        console.log("Publish file v3 tx:", tx.stringify());
+        // Send the transaction
+        const txHash = await this.signer.sendTransaction(tx);
+        return (0, transaction_2.ensureHexPrefix)(txHash);
     }
     /**
-     * Creates a new transaction for publishing content (string or Uint8Array) directly, but doesn't sign or send it
+     * Publishes content (string or Uint8Array) directly to CKBFS v3
      * @param content The content string or byte array to publish
      * @param options Options for publishing the content (contentType and filename are required)
-     * @returns Promise resolving to the unsigned transaction
+     * @returns Promise resolving to the transaction hash
      */
-    async createPublishContentTransaction(content, options) {
+    async publishContentV3(content, options) {
         const contentBytes = typeof content === "string" ? textEncoder.encode(content) : content;
         const contentChunks = [];
         for (let i = 0; i < contentBytes.length; i += this.chunkSize) {
@@ -301,7 +586,7 @@ class CKBFS {
         const lock = await this.getLock();
         // Use provided contentType and filename (required)
         const { contentType, filename } = options;
-        return (0, transaction_1.createPublishTransaction)(this.signer, {
+        const tx = await (0, transaction_1.publishCKBFSV3)(this.signer, {
             contentChunks,
             contentType,
             filename,
@@ -309,53 +594,130 @@ class CKBFS {
             capacity: options.capacity,
             feeRate: options.feeRate,
             network: options.network || this.network,
-            version: options.version || this.version,
             useTypeID: options.useTypeID !== undefined ? options.useTypeID : this.useTypeID,
+            version: constants_1.ProtocolVersion.V3,
         });
+        const txHash = await this.signer.sendTransaction(tx);
+        return (0, transaction_2.ensureHexPrefix)(txHash);
     }
     /**
-     * Creates a new transaction for appending content from a file but doesn't sign or send it
+     * Appends content from a file to an existing CKBFS v3 file
      * @param filePath The path to the file containing the content to append
      * @param ckbfsCell The CKBFS cell to append to
+     * @param previousTxHash The previous transaction hash for backlink
+     * @param previousWitnessIndex The previous witness index for backlink
+     * @param previousChecksum The previous checksum for backlink
      * @param options Additional options for the append operation
-     * @returns Promise resolving to the unsigned transaction
+     * @returns Promise resolving to the transaction hash
      */
-    async createAppendTransaction(filePath, ckbfsCell, options = {}) {
+    async appendFileV3(filePath, ckbfsCell, previousTxHash, previousWitnessIndex, previousChecksum, options = {}) {
         // Read the file and split into chunks
         const fileContent = (0, file_1.readFileAsUint8Array)(filePath);
         const contentChunks = [];
         for (let i = 0; i < fileContent.length; i += this.chunkSize) {
             contentChunks.push(fileContent.slice(i, i + this.chunkSize));
         }
-        // Create the transaction using the utility function
-        return (0, transaction_1.createAppendTransaction)(this.signer, {
+        // Create and sign the transaction using the v3 utility function
+        const tx = await (0, transaction_1.appendCKBFSV3)(this.signer, {
             ckbfsCell,
             contentChunks,
             feeRate: options.feeRate,
             network: options.network || this.network,
-            version: options.version || this.version,
+            version: constants_1.ProtocolVersion.V3,
+            previousTxHash,
+            previousWitnessIndex,
+            previousChecksum,
         });
+        console.log("Append file v3 tx:", tx.stringify());
+        // Send the transaction
+        const txHash = await this.signer.sendTransaction(tx);
+        return (0, transaction_2.ensureHexPrefix)(txHash);
     }
     /**
-     * Creates a new transaction for appending content (string or Uint8Array) directly, but doesn't sign or send it
+     * Appends content (string or Uint8Array) directly to an existing CKBFS v3 file
      * @param content The content string or byte array to append
      * @param ckbfsCell The CKBFS cell to append to
+     * @param previousTxHash The previous transaction hash for backlink
+     * @param previousWitnessIndex The previous witness index for backlink
+     * @param previousChecksum The previous checksum for backlink
      * @param options Additional options for the append operation
-     * @returns Promise resolving to the unsigned transaction
+     * @returns Promise resolving to the transaction hash
      */
-    async createAppendContentTransaction(content, ckbfsCell, options = {}) {
+    async appendContentV3(content, ckbfsCell, previousTxHash, previousWitnessIndex, previousChecksum, options = {}) {
         const contentBytes = typeof content === "string" ? textEncoder.encode(content) : content;
         const contentChunks = [];
         for (let i = 0; i < contentBytes.length; i += this.chunkSize) {
             contentChunks.push(contentBytes.slice(i, i + this.chunkSize));
         }
-        return (0, transaction_1.createAppendTransaction)(this.signer, {
+        const tx = await (0, transaction_1.appendCKBFSV3)(this.signer, {
             ckbfsCell,
             contentChunks,
             feeRate: options.feeRate,
             network: options.network || this.network,
-            version: options.version || this.version,
-            // No useTypeID option for append
+            version: constants_1.ProtocolVersion.V3,
+            previousTxHash,
+            previousWitnessIndex,
+            previousChecksum,
+        });
+        const txHash = await this.signer.sendTransaction(tx);
+        return (0, transaction_2.ensureHexPrefix)(txHash);
+    }
+    /**
+     * Transfers ownership of a CKBFS v3 file to a new lock script
+     * @param ckbfsCell The CKBFS cell to transfer
+     * @param newLock The new lock script for the transferred file
+     * @param previousTxHash The previous transaction hash for backlink
+     * @param previousWitnessIndex The previous witness index for backlink
+     * @param previousChecksum The previous checksum for backlink
+     * @param options Additional options for the transfer operation
+     * @returns Promise resolving to the transaction hash
+     */
+    async transferFileV3(ckbfsCell, newLock, previousTxHash, previousWitnessIndex, previousChecksum, options = {}) {
+        const tx = await (0, transaction_1.transferCKBFSV3)(this.signer, {
+            ckbfsCell,
+            newLock,
+            feeRate: options.feeRate,
+            network: options.network || this.network,
+            version: constants_1.ProtocolVersion.V3,
+            previousTxHash,
+            previousWitnessIndex,
+            previousChecksum,
+        });
+        console.log("Transfer file v3 tx:", tx.stringify());
+        const txHash = await this.signer.sendTransaction(tx);
+        return (0, transaction_2.ensureHexPrefix)(txHash);
+    }
+    /**
+     * Creates a new transaction for publishing a file to CKBFS v3 but doesn't sign or send it
+     * @param filePath The path to the file to publish
+     * @param options Options for publishing the file
+     * @returns Promise resolving to the unsigned transaction
+     */
+    async createPublishV3Transaction(filePath, options = {}) {
+        // Read the file and split into chunks
+        const fileContent = (0, file_1.readFileAsUint8Array)(filePath);
+        const contentChunks = [];
+        for (let i = 0; i < fileContent.length; i += this.chunkSize) {
+            contentChunks.push(fileContent.slice(i, i + this.chunkSize));
+        }
+        // Get the lock script
+        const lock = await this.getLock();
+        // Determine content type if not provided
+        const contentType = options.contentType || (0, file_1.getContentType)(filePath);
+        // Use the filename from the path if not provided
+        const pathParts = filePath.split(/[\\\/]/);
+        const filename = options.filename || pathParts[pathParts.length - 1];
+        // Create the transaction using the utility function
+        return (0, transaction_1.createPublishV3Transaction)(this.signer, {
+            contentChunks,
+            contentType,
+            filename,
+            lock,
+            capacity: options.capacity,
+            feeRate: options.feeRate,
+            network: options.network || this.network,
+            useTypeID: options.useTypeID !== undefined ? options.useTypeID : this.useTypeID,
+            version: constants_1.ProtocolVersion.V3,
         });
     }
 }

package/dist/utils/checksum.d.ts

@@ -31,3 +31,19 @@ export declare function verifyChecksum(data: Uint8Array, expectedChecksum: numbe
 export declare function verifyWitnessChecksum(witness: Uint8Array, expectedChecksum: number, backlinks?: {
     checksum: number;
 }[]): Promise<boolean>;
+/**
+ * Verifies the checksum of a CKBFS v3 witness
+ * @param witness The v3 witness bytes
+ * @param expectedChecksum The expected checksum
+ * @param previousChecksum Optional previous checksum for chained verification
+ * @returns Promise resolving to a boolean indicating whether the checksum is valid
+ */
+export declare function verifyV3WitnessChecksum(witness: Uint8Array, expectedChecksum: number, previousChecksum?: number): Promise<boolean>;
+/**
+ * Verifies the checksum chain for multiple v3 witnesses
+ * @param witnesses Array of v3 witness bytes
+ * @param finalExpectedChecksum The expected final checksum
+ * @param initialChecksum Optional initial checksum (for append operations)
+ * @returns Promise resolving to a boolean indicating whether the checksum chain is valid
+ */
+export declare function verifyV3WitnessChain(witnesses: Uint8Array[], finalExpectedChecksum: number, initialChecksum?: number): Promise<boolean>;