@unifiedflow/unified-flow-sdk 1.0.0

package/dist/client.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnifiedFlowClient = exports.SOL_USD_FEED = exports.CHAINLINK_PROGRAM_ID = void 0;
+const web3_js_1 = require("@solana/web3.js");
+const spl_token_1 = require("@solana/spl-token");
+const pda_1 = require("./pda");
+exports.CHAINLINK_PROGRAM_ID = new web3_js_1.PublicKey("HEvSKofvBgfaexv23kMabbYqxasxU3mQ4ibBMEmJWHny");
+exports.SOL_USD_FEED = new web3_js_1.PublicKey("99B2bTijsU6f1GCT73HmdR7HCFFjGMBcPZY6jZ96ynrR");
+class UnifiedFlowClient {
+    constructor(program) {
+        this.program = program;
+    }
+    /**
+     * Helper to derive the config PDA
+     */
+    getConfigPDA() {
+        return (0, pda_1.getConfigPDA)(this.program.programId)[0];
+    }
+    /**
+     * Create a new stream (Linear, Cliff, or Milestone)
+     */
+    async createStream(creator, recipient, mint, amount, startTs, cliffTs, endTs, vestingType, milestones, nonce) {
+        const config = this.getConfigPDA();
+        const stream = (0, pda_1.getStreamPDA)(creator, recipient, nonce, this.program.programId)[0];
+        const vault = (0, pda_1.getVaultATA)(mint, stream);
+        const creatorTokenAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(mint, creator, true);
+        const builder = this.program.methods
+            .createStream(amount, startTs, cliffTs, endTs, vestingType, milestones, nonce)
+            .accounts({
+            creator,
+            recipient,
+            mint,
+            creatorTokenAccount,
+            tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+        });
+        if (vestingType === 2 && milestones.length > 0) { // VESTING_TYPE_MILESTONE = 2
+            const remainingAccounts = milestones.map((_, i) => ({
+                pubkey: (0, pda_1.getMilestonePDA)(stream, i, this.program.programId)[0],
+                isWritable: true,
+                isSigner: false,
+            }));
+            builder.remainingAccounts(remainingAccounts);
+        }
+        return builder;
+    }
+    /**
+     * Withdraw unlocked/vested tokens from a stream
+     */
+    async withdraw(streamPDA, recipient, mint) {
+        const config = this.getConfigPDA();
+        const vault = (0, pda_1.getVaultATA)(mint, streamPDA);
+        const recipientAta = (0, spl_token_1.getAssociatedTokenAddressSync)(mint, recipient, true);
+        const feeVault = (0, pda_1.getFeeVaultPDA)(this.program.programId)[0];
+        return this.program.methods
+            .withdraw()
+            .accounts({
+            recipient,
+            stream: streamPDA,
+            recipientAta,
+            chainlinkFeed: exports.SOL_USD_FEED,
+            tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+        });
+    }
+    /**
+     * Cancel an active stream and return remaining tokens to the creator
+     */
+    async cancel(streamPDA, creator, recipient, mint) {
+        const config = this.getConfigPDA();
+        const vault = (0, pda_1.getVaultATA)(mint, streamPDA);
+        const creatorTokenAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(mint, creator, true);
+        const recipientTokenAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(mint, recipient, true);
+        return this.program.methods
+            .cancel()
+            .accounts({
+            creator,
+            stream: streamPDA,
+            creatorTokenAccount,
+            recipientTokenAccount,
+            tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+        });
+    }
+    /**
+     * Unlock a specific milestone
+     */
+    async unlockMilestone(streamPDA, creator, milestoneIndex) {
+        const milestonePDA = (0, pda_1.getMilestonePDA)(streamPDA, milestoneIndex, this.program.programId)[0];
+        return this.program.methods
+            .unlockMilestone()
+            .accounts({
+            stream: streamPDA,
+            milestone: milestonePDA,
+        });
+    }
+    /**
+     * Edit a milestone's amount (increase or decrease)
+     */
+    async editMilestone(streamPDA, creator, mint, milestoneIndex, newAmount) {
+        const milestonePDA = (0, pda_1.getMilestonePDA)(streamPDA, milestoneIndex, this.program.programId)[0];
+        const vault = (0, pda_1.getVaultATA)(mint, streamPDA);
+        const creatorTokenAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(mint, creator, true);
+        return this.program.methods
+            .editMilestone(newAmount)
+            .accounts({
+            stream: streamPDA,
+            milestone: milestonePDA,
+            creatorTokenAccount,
+            tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+        });
+    }
+    /**
+     * Edit the cliff timestamp of a cliff vesting stream
+     */
+    async editCliff(streamPDA, creator, newCliffTs) {
+        const config = this.getConfigPDA();
+        return this.program.methods
+            .editCliff(newCliffTs)
+            .accounts({
+            stream: streamPDA,
+        });
+    }
+    /**
+     * Edit a linear stream's end timestamp and/or top up tokens
+     */
+    async editLinear(streamPDA, creator, mint, newEndTs, topupAmount) {
+        const config = this.getConfigPDA();
+        const vault = (0, pda_1.getVaultATA)(mint, streamPDA);
+        const creatorTokenAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(mint, creator, true);
+        return this.program.methods
+            .editLinear(newEndTs, topupAmount)
+            .accounts({
+            stream: streamPDA,
+            creatorTokenAccount,
+            tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+        });
+    }
+}
+exports.UnifiedFlowClient = UnifiedFlowClient;

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./types";
+export * from "./pda";
+export * from "./client";
+import IDL from "./unified_flow.json";
+export { IDL };

package/dist/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IDL = void 0;
+__exportStar(require("./types"), exports);
+__exportStar(require("./pda"), exports);
+__exportStar(require("./client"), exports);
+const unified_flow_json_1 = __importDefault(require("./unified_flow.json"));
+exports.IDL = unified_flow_json_1.default;

package/dist/pda.d.ts

@@ -0,0 +1,8 @@
+import { PublicKey } from "@solana/web3.js";
+import { BN } from "@coral-xyz/anchor";
+export declare const UNIFIED_FLOW_PROGRAM_ID: PublicKey;
+export declare function getConfigPDA(programId?: PublicKey): [PublicKey, number];
+export declare function getFeeVaultPDA(programId?: PublicKey): [PublicKey, number];
+export declare function getStreamPDA(creator: PublicKey, recipient: PublicKey, nonce: BN, programId?: PublicKey): [PublicKey, number];
+export declare function getMilestonePDA(stream: PublicKey, index: number, programId?: PublicKey): [PublicKey, number];
+export declare function getVaultATA(mint: PublicKey, stream: PublicKey): PublicKey;

package/dist/pda.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UNIFIED_FLOW_PROGRAM_ID = void 0;
+exports.getConfigPDA = getConfigPDA;
+exports.getFeeVaultPDA = getFeeVaultPDA;
+exports.getStreamPDA = getStreamPDA;
+exports.getMilestonePDA = getMilestonePDA;
+exports.getVaultATA = getVaultATA;
+const web3_js_1 = require("@solana/web3.js");
+const spl_token_1 = require("@solana/spl-token");
+exports.UNIFIED_FLOW_PROGRAM_ID = new web3_js_1.PublicKey("8M5yieUh7pxwUi1YBByDF82nqoorZwaKi8dBoMVpurFa");
+function getConfigPDA(programId = exports.UNIFIED_FLOW_PROGRAM_ID) {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("config")], programId);
+}
+function getFeeVaultPDA(programId = exports.UNIFIED_FLOW_PROGRAM_ID) {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("fee_vault")], programId);
+}
+function getStreamPDA(creator, recipient, nonce, programId = exports.UNIFIED_FLOW_PROGRAM_ID) {
+    const nonceBuffer = Buffer.alloc(8);
+    nonceBuffer.writeBigUInt64LE(BigInt(nonce.toString()));
+    return web3_js_1.PublicKey.findProgramAddressSync([
+        Buffer.from("stream"),
+        creator.toBuffer(),
+        recipient.toBuffer(),
+        nonceBuffer,
+    ], programId);
+}
+function getMilestonePDA(stream, index, programId = exports.UNIFIED_FLOW_PROGRAM_ID) {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from("milestone"), stream.toBuffer(), Buffer.from([index])], programId);
+}
+function getVaultATA(mint, stream) {
+    return (0, spl_token_1.getAssociatedTokenAddressSync)(mint, stream, true);
+}