@zebec-network/zebec-vault-sdk 1.1.0 → 2.0.0

package/README.md

@@ -1,219 +1,219 @@
-# Zebec Vault Sdk
-
-## Installation
-
-```bash
-yarn add @zebec-network/zebec-vault-sdk
-```
-
-```bash
-npm install @zebec-network/zebec-vault-sdk
-```
-
-## Dependency Map
-
-![Vault SDK Dependency Map](./assets/VaultSDKDependencyMap.png)
-
-## Development
-
-To build the package
-
-```bash
-yarn build
-```
-
-To run specific test filess
-
-```bash
-yarn test <test file path> -f "<regex for test name>"
-// example:
-// yarn test ./test/<filename>.test.ts
-```
-
-## publish
-
-Build package and bump package version to specific need and publish
-
-```bash
-npm publish --access public
-```
-
-## Usage
-
-### Create Vault Instance
-
-```ts
-const network = "devnet";
-const wallet = <Anchor wallet>;
-const connection = <Connection Instance>;
-const provider = createAnchorProvider(connection, wallet);
-const service = await ZebecVaultService.create(provider, network);
-```
-
-### Create Vault
-
-```ts
-const vaultKeypair = Keypair.generate();
-console.log("Vault Keypair:", vaultKeypair.publicKey.toBase58());
-const payload = await service.createVault({
- vaultKeypair,
-});
-
-const signature = await payload.execute({ commitment: "finalized" });
-console.log("Signature:", signature);
-```
-
-### Get Vault Info of User
-
-```ts
-const vaultsInfo = await service.getVaultsInfoOfUser(wallet.publicKey);
-console.log("vaults info:", JSON.stringify(vaultsInfo, null, 2));
-const vault = vaultsInfo[0].vault;
-```
-
-### Deposit Sol
-
-```ts
-const vault = <vault public key>;
-const amount = 2;
-const payload = await service.depositSol({ amount, vault });
-const signature = await payload.execute({ commitment: "finalized" });
-```
-
-### Withdraw Sol
-
-```ts
-const vault = <vault public key>;
-const amount = 0.01;
-const payload = await service.withdrawSol({ amount, vault });
-const signature = await payload.execute({ commitment: "finalized" });
-```
-
-### Deposit Token
-
-```ts
-const tokenMint = "De31sBPcDejCVpZZh1fq8SNs7AcuWcBKuU3k2jqnkmKc";
-const vault = <vault public key>;
-const amount = 1000
-const payload = await service.depositToken({ amount, vault, tokenMint });
-const signature = await payload.execute({ commitment: "finalized" });
-```
-
-### Withdraw Token
-
-```ts
-const vault = <vault public key>;
-const tokenMint = "De31sBPcDejCVpZZh1fq8SNs7AcuWcBKuU3k2jqnkmKc";
-const amount = 1;
-const payload = await service.withdrawToken({ amount, vault, tokenMint });
-const signature = await payload.execute({ commitment: "finalized" });
-```
-
-### Execute Proposal Direct
-
-```ts
-const proposer = <wallet public key>;
-const vault = <vault public key>;
-
-const memoInstruction = new TransactionInstruction({
- keys: [],
- programId: MEMO_PROGRAM_ID,
- data: Buffer.from("This is test memo", "utf8"),
-});
-const actions = [memoInstruction];
-
-const payload = await service.executeProposalDirect({
- actions,
- proposer,
- vault,
-});
-
-const signature = await payload.execute({ commitment: "finalized" });
-console.log("Execute Proposal Direct Signature:", signature);
-```
-
-### Create Proposal
-
-```ts
-const proposer = <wallet public key>;
-const receiver = <wallet public Key>;
-const vault = <vault public key>;
-
-const [vaultSigner] = deriveVaultSigner(vault, service.programId);
-const name = "Transfer Funds";
-const ix = SystemProgram.transfer({
- fromPubkey: vaultSigner,
- toPubkey: receiver,
- lamports: Number(parseSol(1)),
-});
-const actions = [ix];
-const proposalKeypair = Keypair.generate();
-
-const createProposalPayload = await service.createProposal({
- actions,
- name,
- proposer,
- vault,
- proposalKeypair,
-});
-
-const signature = await createProposalPayload.execute({ commitment: "finalized" });
-```
-
-### Append Actions
-
-```ts
-const proposal = <proposal public key>;
-
-const ixB = new TransactionInstruction({
- keys: [],
- programId: MEMO_PROGRAM_ID,
- data: Buffer.from("This is test memo", "utf8"),
-});
-const actionsB = [ixB];
-
-const appendActionsPayload = await service.appendActions({
- actions: actionsB,
- proposal,
-});
-
-const appendActionsSignature = await appendActionsPayload.execute({ commitment: "confirmed" });
-```
-
-### Execute Proposal
-
-```ts
-const proposal = <proposal public key>;
-const payload = await service.executeProposal({
-   proposal,
-});
-
-const signature = await payload.execute({ commitment: "confirmed" });
-console.log("Execute Proposal Signature:", signature);
-```
-
-### Delete Proposal
-
-```ts
-const proposal = <proposal public key>;
-
-const deleteProposalPayload = await service.deleteProposal({ proposal });
-const deleteProposalSignature = await deleteProposalPayload.execute({
- commitment: "confirmed",
-});
-console.log("Delete Proposal Signature:", deleteProposalSignature);
-```
-
-### Get Proposals Info of a Vault
-
-```ts
-const vault = <vault public key>;
-
-const proposalsInfo = await service.getProposalsInfoOfVault(vault);
-```
-
-### Get All Vaults Info
-
-```ts
-const vaultsInfo = await service.getAllVaultsInfo();
-```
+# Zebec Vault Sdk
+
+## Installation
+
+```bash
+yarn add @zebec-network/zebec-vault-sdk
+```
+
+```bash
+npm install @zebec-network/zebec-vault-sdk
+```
+
+## Dependency Map
+
+![Vault SDK Dependency Map](./assets/VaultSDKDependencyMap.png)
+
+## Development
+
+To build the package
+
+```bash
+yarn build
+```
+
+To run specific test filess
+
+```bash
+yarn test <test file path> -f "<regex for test name>"
+// example:
+// yarn test ./test/<filename>.test.ts
+```
+
+## publish
+
+Build package and bump package version to specific need and publish
+
+```bash
+npm publish --access public
+```
+
+## Usage
+
+### Create Vault Instance
+
+```ts
+const network = "devnet";
+const wallet = <Anchor wallet>;
+const connection = <Connection Instance>;
+const provider = createAnchorProvider(connection, wallet);
+const service = await ZebecVaultService.create(provider, network);
+```
+
+### Create Vault
+
+```ts
+const vaultKeypair = Keypair.generate();
+console.log("Vault Keypair:", vaultKeypair.publicKey.toBase58());
+const payload = await service.createVault({
+ vaultKeypair,
+});
+
+const signature = await payload.execute({ commitment: "finalized" });
+console.log("Signature:", signature);
+```
+
+### Get Vault Info of User
+
+```ts
+const vaultsInfo = await service.getVaultsInfoOfUser(wallet.publicKey);
+console.log("vaults info:", JSON.stringify(vaultsInfo, null, 2));
+const vault = vaultsInfo[0].vault;
+```
+
+### Deposit Sol
+
+```ts
+const vault = <vault public key>;
+const amount = 2;
+const payload = await service.depositSol({ amount, vault });
+const signature = await payload.execute({ commitment: "finalized" });
+```
+
+### Withdraw Sol
+
+```ts
+const vault = <vault public key>;
+const amount = 0.01;
+const payload = await service.withdrawSol({ amount, vault });
+const signature = await payload.execute({ commitment: "finalized" });
+```
+
+### Deposit Token
+
+```ts
+const tokenMint = "De31sBPcDejCVpZZh1fq8SNs7AcuWcBKuU3k2jqnkmKc";
+const vault = <vault public key>;
+const amount = 1000
+const payload = await service.depositToken({ amount, vault, tokenMint });
+const signature = await payload.execute({ commitment: "finalized" });
+```
+
+### Withdraw Token
+
+```ts
+const vault = <vault public key>;
+const tokenMint = "De31sBPcDejCVpZZh1fq8SNs7AcuWcBKuU3k2jqnkmKc";
+const amount = 1;
+const payload = await service.withdrawToken({ amount, vault, tokenMint });
+const signature = await payload.execute({ commitment: "finalized" });
+```
+
+### Execute Proposal Direct
+
+```ts
+const proposer = <wallet public key>;
+const vault = <vault public key>;
+
+const memoInstruction = new TransactionInstruction({
+ keys: [],
+ programId: MEMO_PROGRAM_ID,
+ data: Buffer.from("This is test memo", "utf8"),
+});
+const actions = [memoInstruction];
+
+const payload = await service.executeProposalDirect({
+ actions,
+ proposer,
+ vault,
+});
+
+const signature = await payload.execute({ commitment: "finalized" });
+console.log("Execute Proposal Direct Signature:", signature);
+```
+
+### Create Proposal
+
+```ts
+const proposer = <wallet public key>;
+const receiver = <wallet public Key>;
+const vault = <vault public key>;
+
+const [vaultSigner] = deriveVaultSigner(vault, service.programId);
+const name = "Transfer Funds";
+const ix = SystemProgram.transfer({
+ fromPubkey: vaultSigner,
+ toPubkey: receiver,
+ lamports: Number(parseSol(1)),
+});
+const actions = [ix];
+const proposalKeypair = Keypair.generate();
+
+const createProposalPayload = await service.createProposal({
+ actions,
+ name,
+ proposer,
+ vault,
+ proposalKeypair,
+});
+
+const signature = await createProposalPayload.execute({ commitment: "finalized" });
+```
+
+### Append Actions
+
+```ts
+const proposal = <proposal public key>;
+
+const ixB = new TransactionInstruction({
+ keys: [],
+ programId: MEMO_PROGRAM_ID,
+ data: Buffer.from("This is test memo", "utf8"),
+});
+const actionsB = [ixB];
+
+const appendActionsPayload = await service.appendActions({
+ actions: actionsB,
+ proposal,
+});
+
+const appendActionsSignature = await appendActionsPayload.execute({ commitment: "confirmed" });
+```
+
+### Execute Proposal
+
+```ts
+const proposal = <proposal public key>;
+const payload = await service.executeProposal({
+   proposal,
+});
+
+const signature = await payload.execute({ commitment: "confirmed" });
+console.log("Execute Proposal Signature:", signature);
+```
+
+### Delete Proposal
+
+```ts
+const proposal = <proposal public key>;
+
+const deleteProposalPayload = await service.deleteProposal({ proposal });
+const deleteProposalSignature = await deleteProposalPayload.execute({
+ commitment: "confirmed",
+});
+console.log("Delete Proposal Signature:", deleteProposalSignature);
+```
+
+### Get Proposals Info of a Vault
+
+```ts
+const vault = <vault public key>;
+
+const proposalsInfo = await service.getProposalsInfoOfVault(vault);
+```
+
+### Get All Vaults Info
+
+```ts
+const vaultsInfo = await service.getAllVaultsInfo();
+```

package/dist/artifacts/zebec_vault.d.ts

@@ -24,6 +24,18 @@ export type ZebecVault = {
                 },
                 {
                     name: "vault";
+                    pda: {
+                        seeds: [
+                            {
+                                kind: "const";
+                                value: [122, 101, 98, 101, 99, 95, 117, 115, 101, 114, 95, 118, 97, 117, 108, 116];
+                            },
+                            {
+                                kind: "account";
+                                path: "proposer";
+                            }
+                        ];
+                    };
                     relations: ["proposal"];
                 },
                 {
@@ -57,6 +69,18 @@ export type ZebecVault = {
                 },
                 {
                     name: "vault";
+                    pda: {
+                        seeds: [
+                            {
+                                kind: "const";
+                                value: [122, 101, 98, 101, 99, 95, 117, 115, 101, 114, 95, 118, 97, 117, 108, 116];
+                            },
+                            {
+                                kind: "account";
+                                path: "proposer";
+                            }
+                        ];
+                    };
                 },
                 {
                     name: "proposal";
@@ -91,7 +115,18 @@ export type ZebecVault = {
                 {
                     name: "vault";
                     writable: true;
-                    signer: true;
+                    pda: {
+                        seeds: [
+                            {
+                                kind: "const";
+                                value: [122, 101, 98, 101, 99, 95, 117, 115, 101, 114, 95, 118, 97, 117, 108, 116];
+                            },
+                            {
+                                kind: "account";
+                                path: "payer";
+                            }
+                        ];
+                    };
                 },
                 {
                     name: "systemProgram";
@@ -119,6 +154,18 @@ export type ZebecVault = {
                 },
                 {
                     name: "vault";
+                    pda: {
+                        seeds: [
+                            {
+                                kind: "const";
+                                value: [122, 101, 98, 101, 99, 95, 117, 115, 101, 114, 95, 118, 97, 117, 108, 116];
+                            },
+                            {
+                                kind: "account";
+                                path: "proposer";
+                            }
+                        ];
+                    };
                     relations: ["proposal"];
                 },
                 {
@@ -140,6 +187,18 @@ export type ZebecVault = {
                 {
                     name: "vault";
                     writable: true;
+                    pda: {
+                        seeds: [
+                            {
+                                kind: "const";
+                                value: [122, 101, 98, 101, 99, 95, 117, 115, 101, 114, 95, 118, 97, 117, 108, 116];
+                            },
+                            {
+                                kind: "account";
+                                path: "depositor";
+                            }
+                        ];
+                    };
                 },
                 {
                     name: "vaultSigner";
@@ -184,6 +243,18 @@ export type ZebecVault = {
                 },
                 {
                     name: "vault";
+                    pda: {
+                        seeds: [
+                            {
+                                kind: "const";
+                                value: [122, 101, 98, 101, 99, 95, 117, 115, 101, 114, 95, 118, 97, 117, 108, 116];
+                            },
+                            {
+                                kind: "account";
+                                path: "depositor";
+                            }
+                        ];
+                    };
                 },
                 {
                     name: "vaultSigner";
@@ -421,6 +492,18 @@ export type ZebecVault = {
                 },
                 {
                     name: "vault";
+                    pda: {
+                        seeds: [
+                            {
+                                kind: "const";
+                                value: [122, 101, 98, 101, 99, 95, 117, 115, 101, 114, 95, 118, 97, 117, 108, 116];
+                            },
+                            {
+                                kind: "account";
+                                path: "caller";
+                            }
+                        ];
+                    };
                     relations: ["proposal"];
                 },
                 {
@@ -452,6 +535,18 @@ export type ZebecVault = {
                 },
                 {
                     name: "vault";
+                    pda: {
+                        seeds: [
+                            {
+                                kind: "const";
+                                value: [122, 101, 98, 101, 99, 95, 117, 115, 101, 114, 95, 118, 97, 117, 108, 116];
+                            },
+                            {
+                                kind: "account";
+                                path: "proposer";
+                            }
+                        ];
+                    };
                 },
                 {
                     name: "vaultSigner";
@@ -495,7 +590,18 @@ export type ZebecVault = {
                 },
                 {
                     name: "vault";
-                    writable: true;
+                    pda: {
+                        seeds: [
+                            {
+                                kind: "const";
+                                value: [122, 101, 98, 101, 99, 95, 117, 115, 101, 114, 95, 118, 97, 117, 108, 116];
+                            },
+                            {
+                                kind: "account";
+                                path: "withdrawer";
+                            }
+                        ];
+                    };
                 },
                 {
                     name: "vaultSigner";
@@ -540,6 +646,18 @@ export type ZebecVault = {
                 },
                 {
                     name: "vault";
+                    pda: {
+                        seeds: [
+                            {
+                                kind: "const";
+                                value: [122, 101, 98, 101, 99, 95, 117, 115, 101, 114, 95, 118, 97, 117, 108, 116];
+                            },
+                            {
+                                kind: "account";
+                                path: "withdrawer";
+                            }
+                        ];
+                    };
                 },
                 {
                     name: "vaultSigner";
@@ -1476,6 +1594,13 @@ export type ZebecVault = {
         }
     ];
     constants: [
+        {
+            name: "userVaultPrefix";
+            type: {
+                array: ["u8", 16];
+            };
+            value: "[122, 101, 98, 101, 99, 95, 117, 115, 101, 114, 95, 118, 97, 117, 108, 116]";
+        },
         {
             name: "vaultSignerPrefix";
             type: {