{"_id":"@deriverse/sqds-admin-kit","_rev":"4-f7bd6acabd68db7134021c702e56533e","name":"@deriverse/sqds-admin-kit","dist-tags":{"latest":"1.0.8"},"versions":{"1.0.1":{"name":"@deriverse/sqds-admin-kit","version":"1.0.1","keywords":["deriverse"],"author":{"name":"Deriverse","email":"hello@deriverse.io"},"license":"Apache-2.0","_id":"@deriverse/sqds-admin-kit@1.0.1","maintainers":[{"name":"gs-deriverse","email":"george@deriverse.io"}],"homepage":"https://github.com/deriverse/sqds-admin-kit#readme","bugs":{"url":"https://github.com/deriverse/sqds-admin-kit/issues"},"dist":{"shasum":"e56ffc73e3d880f0bbcdad9e8812ea2b270a6bf9","tarball":"https://registry.npmjs.org/@deriverse/sqds-admin-kit/-/sqds-admin-kit-1.0.1.tgz","fileCount":16,"integrity":"sha512-za5JqMFDyzNsoPgs7DDQEeFY+Vlq7ZpBHPiTUPu9NApjGMmbqTgLAm2S4gMRjZOpvFZrgy4cZdK9/4G9zAr5xw==","signatures":[{"sig":"MEUCIBj79LO1j3U4JCefIZl8KcCIrwavUtjd2vaDxFSxQzzRAiEAj3O8BXXODxQE+EAvOBNxnaEHN3FdaOMCOTVjKuXgW9o=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":219951},"main":"./dist/cjs/index.js","types":"./dist/types/index.d.ts","module":"./dist/esm/index.js","engines":{"node":">=18.0.0"},"exports":{".":{"import":{"types":"./dist/types/index.d.ts","default":"./dist/esm/index.js"},"require":{"types":"./dist/types/index.d.ts","default":"./dist/cjs/index.js"}}},"gitHead":"d11717e9dd85c98528f61ecbba3daf9f5bae0b17","scripts":{"lint":"tsc --noEmit","test":"echo \"No tests specified\" && exit 0","build":"npm run clean && npm run build:cjs && npm run build:esm && npm run build:types","clean":"rm -rf dist","prepack":"npm run build","build:cjs":"tsc -p tsconfig.cjs.json","build:esm":"tsc -p tsconfig.esm.json","build:types":"tsc -p tsconfig.types.json","prepublishOnly":"npm run build"},"_npmUser":{"name":"gs-deriverse","email":"george@deriverse.io"},"repository":{"url":"git+https://github.com/deriverse/sqds-admin-kit.git","type":"git"},"_npmVersion":"10.8.2","description":"TypeScript SDK for Deriverse protocol administration via Squads multisig on Solana","directories":{},"sideEffects":false,"_nodeVersion":"20.17.0","dependencies":{"bs58":"^5.0.0","@solana/compat":"^3.0.2","@sqds/multisig":"^2.1.3","@solana/web3.js":"1.98.4","@solana/spl-token":"^0.4.3","base64-arraybuffer":"^1.0.2","@solana-program/system":"^0.7.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.4.3","@types/node":"^22.14.0"},"peerDependencies":{"@solana/web3.js":">=1.90.0"},"peerDependenciesMeta":{"@solana/web3.js":{"optional":false}},"_npmOperationalInternal":{"tmp":"tmp/sqds-admin-kit_1.0.1_1765031392564_0.2811103905237988","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@deriverse/sqds-admin-kit","version":"1.0.3","keywords":["deriverse"],"author":{"name":"Deriverse","email":"hello@deriverse.io"},"license":"Apache-2.0","_id":"@deriverse/sqds-admin-kit@1.0.3","maintainers":[{"name":"gs-deriverse","email":"george@deriverse.io"}],"homepage":"https://github.com/deriverse/sqds-admin-kit#readme","bugs":{"url":"https://github.com/deriverse/sqds-admin-kit/issues"},"dist":{"shasum":"ee27b4b5a4afbcbae3154c09ac02769c1ddf8993","tarball":"https://registry.npmjs.org/@deriverse/sqds-admin-kit/-/sqds-admin-kit-1.0.3.tgz","fileCount":16,"integrity":"sha512-VMI6bs0houxwD1rtMLkR2a/4/Zv5LpaN3p+PUoI9mTzsknrQGI9gK6GJbqWAke/DAqLciZ8poSj58RMMM9HehQ==","signatures":[{"sig":"MEUCIQDDZ1R0dAZbJi/ze2Wtvbx5x4lZ9Dz6/j81i8p+/+ZGVgIgFy0t7D+cif/RvVL0y987ZJoUmDABoxsQFYc/okB+hsE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":234720},"main":"./dist/cjs/index.js","types":"./dist/types/index.d.ts","module":"./dist/esm/index.js","engines":{"node":">=18.0.0"},"exports":{".":{"import":{"types":"./dist/types/index.d.ts","default":"./dist/esm/index.js"},"require":{"types":"./dist/types/index.d.ts","default":"./dist/cjs/index.js"}}},"gitHead":"5d755d54550b2ba0152cb6eb08943917ea463b69","scripts":{"lint":"tsc -p tsconfig.esm.json --noEmit","test":"echo \"No tests specified\" && exit 0","build":"npm run build:cjs && npm run build:esm && npm run build:types","clean":"rm -rf dist","prepack":"npm run build","build:cjs":"tsc -p tsconfig.cjs.json","build:esm":"tsc -p tsconfig.esm.json","build:types":"tsc -p tsconfig.types.json","prepublishOnly":"npm run build"},"_npmUser":{"name":"gs-deriverse","email":"george@deriverse.io"},"repository":{"url":"git+https://github.com/deriverse/sqds-admin-kit.git","type":"git"},"_npmVersion":"10.8.2","description":"TypeScript SDK for Deriverse protocol administration via Squads multisig on Solana","directories":{},"sideEffects":false,"_nodeVersion":"20.17.0","dependencies":{"bs58":"^5.0.0","@solana/compat":"^3.0.2","@sqds/multisig":"^2.1.3","@solana/web3.js":"1.98.4","@solana/spl-token":"^0.4.3","base64-arraybuffer":"^1.0.2","@solana-program/system":"^0.7.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.4.3","@types/node":"^22.14.0"},"peerDependencies":{"@solana/web3.js":">=1.90.0"},"peerDependenciesMeta":{"@solana/web3.js":{"optional":false}},"_npmOperationalInternal":{"tmp":"tmp/sqds-admin-kit_1.0.3_1765104777852_0.6178886381871871","host":"s3://npm-registry-packages-npm-production"}},"1.0.7":{"name":"@deriverse/sqds-admin-kit","version":"1.0.7","keywords":["deriverse"],"author":{"name":"Deriverse","email":"hello@deriverse.io"},"license":"Apache-2.0","_id":"@deriverse/sqds-admin-kit@1.0.7","maintainers":[{"name":"gs-deriverse","email":"george@deriverse.io"}],"homepage":"https://github.com/deriverse/sqds-admin-kit#readme","bugs":{"url":"https://github.com/deriverse/sqds-admin-kit/issues"},"dist":{"shasum":"31189fab5785de3fddd3348bceb74c0d4799a5c7","tarball":"https://registry.npmjs.org/@deriverse/sqds-admin-kit/-/sqds-admin-kit-1.0.7.tgz","fileCount":16,"integrity":"sha512-tCc9QBeR8/XhDbn3GYLlIMDoyq4s5n5/eZymk7D+XikZrtST3DWZFrMiASb4hbH1HgG0ie+jlwzcB7VzmNuAGw==","signatures":[{"sig":"MEUCIQDcfGVaPErYdLciznqqobAzsHqNxmDJt12gxvr6QtlOXAIgQv4Czh/isW/KrzDt+Oq5d4CGgB1H42akNYhDeuY7KRI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":238734},"main":"./dist/cjs/index.js","types":"./dist/types/index.d.ts","module":"./dist/esm/index.js","engines":{"node":">=18.0.0"},"exports":{".":{"import":{"types":"./dist/types/index.d.ts","default":"./dist/esm/index.js"},"require":{"types":"./dist/types/index.d.ts","default":"./dist/cjs/index.js"}}},"gitHead":"0927fef5b7f74d4c28ad6a7e26e401d8d8231014","scripts":{"lint":"tsc -p tsconfig.esm.json --noEmit","test":"echo \"No tests specified\" && exit 0","build":"npm run build:cjs && npm run build:esm && npm run build:types","clean":"rm -rf dist","prepack":"npm run build","build:cjs":"tsc -p tsconfig.cjs.json","build:esm":"tsc -p tsconfig.esm.json","build:types":"tsc -p tsconfig.types.json","prepublishOnly":"npm run build"},"_npmUser":{"name":"gs-deriverse","email":"george@deriverse.io"},"repository":{"url":"git+https://github.com/deriverse/sqds-admin-kit.git","type":"git"},"_npmVersion":"10.8.2","description":"TypeScript SDK for Deriverse protocol administration via Squads multisig on Solana","directories":{},"sideEffects":false,"_nodeVersion":"20.17.0","dependencies":{"bs58":"^5.0.0","@solana/compat":"^3.0.2","@sqds/multisig":"^2.1.3","@solana/web3.js":"1.98.4","@solana/spl-token":"^0.4.3","base64-arraybuffer":"^1.0.2","@solana-program/system":"^0.7.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.4.3","@types/node":"^22.14.0"},"peerDependencies":{"@solana/web3.js":">=1.90.0"},"peerDependenciesMeta":{"@solana/web3.js":{"optional":false}},"_npmOperationalInternal":{"tmp":"tmp/sqds-admin-kit_1.0.7_1770379574026_0.44483405688984723","host":"s3://npm-registry-packages-npm-production"}},"1.0.8":{"name":"@deriverse/sqds-admin-kit","version":"1.0.8","description":"TypeScript SDK for Deriverse protocol administration via Squads multisig on Solana","keywords":["deriverse"],"author":{"name":"Deriverse","email":"hello@deriverse.io"},"license":"Apache-2.0","homepage":"https://github.com/deriverse/sqds-admin-kit#readme","repository":{"type":"git","url":"git+https://github.com/deriverse/sqds-admin-kit.git"},"bugs":{"url":"https://github.com/deriverse/sqds-admin-kit/issues"},"main":"./dist/cjs/index.js","module":"./dist/esm/index.js","types":"./dist/types/index.d.ts","exports":{".":{"import":{"types":"./dist/types/index.d.ts","default":"./dist/esm/index.js"},"require":{"types":"./dist/types/index.d.ts","default":"./dist/cjs/index.js"}}},"sideEffects":false,"engines":{"node":">=18.0.0"},"scripts":{"clean":"rm -rf dist","build:cjs":"tsc -p tsconfig.cjs.json","build:esm":"tsc -p tsconfig.esm.json","build:types":"tsc -p tsconfig.types.json","build":"npm run build:cjs && npm run build:esm && npm run build:types","prepublishOnly":"npm run build","test":"echo \"No tests specified\" && exit 0","lint":"tsc -p tsconfig.esm.json --noEmit","prepack":"npm run build"},"devDependencies":{"@types/node":"^22.14.0","typescript":"^5.4.3"},"dependencies":{"@solana-program/system":"^0.7.0","@solana/compat":"^3.0.2","@solana/spl-token":"^0.4.3","@solana/web3.js":"1.98.4","@sqds/multisig":"^2.1.3","base64-arraybuffer":"^1.0.2","bs58":"^5.0.0"},"peerDependencies":{"@solana/web3.js":">=1.90.0"},"peerDependenciesMeta":{"@solana/web3.js":{"optional":false}},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_id":"@deriverse/sqds-admin-kit@1.0.8","gitHead":"b17b35e35fe7afd329590efa500d87e3329a0e88","_nodeVersion":"20.17.0","_npmVersion":"10.8.2","dist":{"integrity":"sha512-XXVkokX60mH0NNabfVSgzZpa6CajIN5Pf0dYV4io2Z1AaWdpfSUjarM3Ku7Qh5Np/skcpLiPkTqhD9ExUnwEWw==","shasum":"483074463ffb28657b0af66aea4914ac2f1bfd5d","tarball":"https://registry.npmjs.org/@deriverse/sqds-admin-kit/-/sqds-admin-kit-1.0.8.tgz","fileCount":16,"unpackedSize":238734,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIA0jFtg8WXr8UxOgoCVxREOpqIf9qdPu1xIssTqBn8b7AiAKqI1fQrHGJ1+lBQ84azESJ/Zdn9ZL6vm6uzPiWe4hIQ=="}]},"_npmUser":{"name":"gs-deriverse","email":"george@deriverse.io"},"directories":{},"maintainers":[{"name":"gs-deriverse","email":"george@deriverse.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sqds-admin-kit_1.0.8_1770485378350_0.2574426790699069"},"_hasShrinkwrap":false}},"time":{"created":"2025-12-06T14:29:52.508Z","modified":"2026-02-07T17:29:38.689Z","1.0.1":"2025-12-06T14:29:52.703Z","1.0.3":"2025-12-07T10:52:57.991Z","1.0.7":"2026-02-06T12:06:14.173Z","1.0.8":"2026-02-07T17:29:38.520Z"},"bugs":{"url":"https://github.com/deriverse/sqds-admin-kit/issues"},"author":{"name":"Deriverse","email":"hello@deriverse.io"},"license":"Apache-2.0","homepage":"https://github.com/deriverse/sqds-admin-kit#readme","keywords":["deriverse"],"repository":{"type":"git","url":"git+https://github.com/deriverse/sqds-admin-kit.git"},"description":"TypeScript SDK for Deriverse protocol administration via Squads multisig on Solana","maintainers":[{"name":"gs-deriverse","email":"george@deriverse.io"}],"readme":"# @deriverse/sqds-admin-kit\n\nTypeScript SDK for Deriverse protocol administration via [Squads](https://squads.so/) multisig on Solana.\n\n## Features\n\n- Create Squads multisig transactions for Deriverse protocol operations\n- Type-safe interface with full TypeScript support\n- Dual ESM/CommonJS module support\n- Comprehensive documentation with JSDoc comments\n\n## Installation\n\n```bash\nnpm install @deriverse/sqds-admin-kit\n# or\nyarn add @deriverse/sqds-admin-kit\n# or\npnpm add @deriverse/sqds-admin-kit\n```\n\n## Requirements\n\n- Node.js >= 18.0.0\n- `@solana/web3.js` >= 1.90.0 (peer dependency)\n\n## Quick Start\n\n```typescript\nimport { AdminEngine } from '@deriverse/sqds-admin-kit';\nimport { Connection, PublicKey } from '@solana/web3.js';\n\n// Initialize connection\nconst connection = new Connection('https://api.mainnet-beta.solana.com');\n\n// Create AdminEngine instance\nconst engine = new AdminEngine({\n  connection,\n  proposer: new PublicKey('YOUR_PROPOSER_PUBKEY'),\n});\n\n// Create a multisig transaction instruction\nconst instruction = await engine.newHolderAccountInstruction();\n```\n\n## API Reference\n\n### AdminEngine\n\nThe main class for interacting with the Deriverse protocol via Squads multisig.\n\n#### Constructor\n\n```typescript\nconst engine = new AdminEngine({\n  connection: Connection,      // Solana RPC connection\n  proposer: PublicKey,         // Transaction proposer public key\n  programId?: PublicKey,       // Optional: Custom program ID (defaults to mainnet)\n  holderMultisigPda?: PublicKey,   // Optional: Holder multisig PDA\n  operatorMultisigPda?: PublicKey, // Optional: Operator multisig PDA\n  clientMultisigPda?: PublicKey,   // Optional: Client multisig PDA\n  holderVaultIndex?: number,   // Optional: Holder vault index (default: 0)\n  operatorVaultIndex?: number, // Optional: Operator vault index (default: 0)\n  clientVaultIndex?: number,   // Optional: Client vault index (default: 0)\n  privateModeAuthority?: PublicKey, // Optional: Private mode authority\n  drvsMint?: PublicKey,        // Optional: DRVS mint address\n  version?: number,            // Optional: Protocol version\n});\n```\n\n### Holder Operations\n\n#### `newHolderAccountInstruction()`\nCreate a new holder account.\n\n```typescript\nconst ix = await engine.newHolderAccountInstruction();\n```\n\n#### `newOperatorInstruction()`\nAdd a new operator to the protocol.\n\n```typescript\nconst ix = await engine.newOperatorInstruction();\n```\n\n### Operator Operations\n\n#### `newRootAccountInstruction(args?)`\nInitialize the root account.\n\n```typescript\nconst ix = await engine.newRootAccountInstruction({\n  privateMode: true, // Enable private mode\n});\n```\n\n#### `newBaseCurrencyInstruction(args?)`\nAdd a new base currency to the protocol.\n\n```typescript\nimport { USDC_MINT } from '@deriverse/sqds-admin-kit';\n\nconst ix = await engine.newBaseCurrencyInstruction({\n  newBaseCrncyMint: USDC_MINT,\n});\n```\n\n#### `setVarianceInstruction(args)`\nSet variance for an instrument.\n\n```typescript\nconst ix = await engine.setVarianceInstruction({\n  assetTokenId: 1,\n  crncyTokenId: 0,\n  variance: 0.04, // 4%\n});\n```\n\n#### `setInstrReadyForPerpUpgradeInstruction(args)`\nMark an instrument as ready for perpetual upgrade.\n\n```typescript\nconst ix = await engine.setInstrReadyForPerpUpgradeInstruction({\n  assetTokenId: 1,\n  crncyTokenId: 0,\n});\n```\n\n#### `terminatePrivateModeInstruction()`\nTerminate private mode.\n\n```typescript\nconst ix = await engine.terminatePrivateModeInstruction();\n```\n\n#### `changePrivateModeAuthorityInstruction(args)`\nChange the private mode authority.\n\n```typescript\nconst ix = await engine.changePrivateModeAuthorityInstruction({\n  authority: new PublicKey('NEW_AUTHORITY'),\n});\n```\n\n#### `changeAirdropAuthorityInstruction(args)`\nChange the airdrop authority.\n\n```typescript\nconst ix = await engine.changeAirdropAuthorityInstruction({\n  authority: new PublicKey('NEW_AUTHORITY'),\n});\n```\n\n#### `changePointsProgramExpirationInstruction(args)`\nChange the points program expiration.\n\n```typescript\nconst ix = await engine.changePointsProgramExpirationInstruction({\n  date: new Date('2025-12-31'),\n});\n```\n\n#### `changeRefProgramInstruction(args)`\nChange the referral program parameters.\n\n```typescript\nconst ix = await engine.changeRefProgramInstruction({\n  programDuration: 86400 * 30, // 30 days\n  linkDuration: 86400 * 7,    // 7 days\n  feesDiscount: 0.1,          // 10% discount\n  feesRatio: 0.5,             // 50% ratio\n});\n```\n\n#### `votingResetInstruction()`\nReset voting.\n\n```typescript\nconst ix = await engine.votingResetInstruction();\n```\n\n### Client Operations\n\n#### `depositInstruction(args)`\nDeposit tokens.\n\n```typescript\nconst ix = await engine.depositInstruction({\n  mint: USDC_MINT,\n  amount: 100,\n});\n```\n\n#### `withdrawInstruction(args)`\nWithdraw tokens.\n\n```typescript\nconst ix = await engine.withdrawInstruction({\n  mint: USDC_MINT,\n  amount: 50,\n});\n```\n\n#### `spotLpInstruction(args)`\nExecute a spot LP operation.\n\n```typescript\nconst ix = await engine.spotLpInstruction({\n  assetTokenId: 1,\n  crncyTokenId: 0,\n  side: 0,        // 0 = buy, 1 = sell\n  amount: 10,     // percentage\n  edgePrice: 1.5,\n});\n```\n\n#### `dividendsClaimInstruction()`\nClaim dividends.\n\n```typescript\nconst ix = await engine.dividendsClaimInstruction();\n```\n\n#### `votingInstruction(args)`\nSubmit a vote.\n\n```typescript\nconst ix = await engine.votingInstruction({\n  choice: 1,\n  votingCounter: 42,\n});\n```\n\n### Direct Instructions (No Multisig Wrapper)\n\n#### `newPrivateClientInstruction(args)`\nAdd a private client (returns raw instruction, not wrapped in multisig).\n\n```typescript\nconst ix = engine.newPrivateClientInstruction({\n  wallet: new PublicKey('CLIENT_WALLET'),\n  lifeTime: 86400 * 365, // 1 year in seconds\n});\n```\n\n### Utility Methods\n\n#### `findGeneralPda(tag)`\nFind a general PDA by tag.\n\n#### `findInstrPDA(args)`\nFind an instrument PDA.\n\n#### `rootAccount()`\nGet the root account PDA.\n\n#### `communityAccount()`\nGet the community account PDA.\n\n#### `privateClientsAccount()`\nGet the private clients account PDA.\n\n#### `tokenAccount(mint)`\nGet a token account PDA for a given mint.\n\n#### `clientPrimaryAccount()`\nGet the client primary account PDA.\n\n#### `clientCommunityAccount()`\nGet the client community account PDA.\n\n#### `checkAccount(account)`\nCheck if an account exists on-chain.\n\n## Constants\n\nThe package exports the following constants:\n\n```typescript\nimport {\n  VERSION,                // Current protocol version\n  PROGRAM_ID,             // Deriverse program ID\n  DRVS_MINT,              // DRVS token mint\n  USDC_MINT,              // USDC token mint\n  HOLDER_MULTISIG_PDA,    // Holder multisig PDA\n  OPERATOR_MULTISIG_PDA,  // Operator multisig PDA\n  CLIENT_MULTISIG_PDA,    // Client multisig PDA\n  PRIVATE_MODE_AUTHORITY, // Private mode authority\n  HOLDER_ACCOUNT_SEED,    // Holder account seed\n  DRVS_AUTHORITY_SEED,    // DRVS authority seed\n} from '@deriverse/sqds-admin-kit';\n```\n\n## TypeScript Support\n\nThis package includes TypeScript definitions. All interfaces are exported:\n\n```typescript\nimport type {\n  AdminEngineArgs,\n  GetInstrPdaArgs,\n  NewRootAccountArgs,\n  NewBaseCurrencyArgs,\n  NewPrivateClientArgs,\n  DepositArgs,\n  WithdrawArgs,\n  SetVarianceArgs,\n  SetInstrReadyForPerpUpgradeArgs,\n  SpotLpArgs,\n  VotingArgs,\n  ChangePrivateModeAuthorityArgs,\n  ChangeAirdropAuthorityArgs,\n  ChangePointsProgramExpirationArgs,\n  ChangeRefProgramArgs,\n} from '@deriverse/sqds-admin-kit';\n```\n\n## License\n\nApache-2.0\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## Links\n\n- [Deriverse](https://deriverse.io)\n- [Squads Protocol](https://squads.so)\n- [GitHub Repository](https://github.com/deriverse/sqds-admin-kit)\n- [npm Package](https://www.npmjs.com/package/@deriverse/sqds-admin-kit)\n","readmeFilename":"README.md"}