@grapenpm/gpass-sdk 0.1.0 → 0.1.2

package/README.md

@@ -1,4 +1,4 @@
-# @grape-protocol/gpass-sdk
+# @grapenpm/gpass-sdk
 
 TypeScript SDK for the **Grape Gating Protocol** — composable access control for Solana DAOs.
 
@@ -9,7 +9,7 @@ TypeScript SDK for the **Grape Gating Protocol** — composable access control f
 ## Install
 
 ```bash
-npm install @grape-protocol/gpass-sdk
+npm install @grapenpm/gpass-sdk
 # peer deps
 npm install @coral-xyz/anchor @solana/web3.js
 ```
@@ -19,7 +19,7 @@ npm install @coral-xyz/anchor @solana/web3.js
 ## Quick Start
 
 ```typescript
-import { GpassClient, GateCriteriaFactory, GateTypeFactory, VerificationPlatform } from "@grape-protocol/gpass-sdk";
+import { GpassClient, GateCriteriaFactory, GateTypeFactory, VerificationPlatform } from "@grapenpm/gpass-sdk";
 import { AnchorProvider } from "@coral-xyz/anchor";
 import { Keypair } from "@solana/web3.js";
 
@@ -62,10 +62,24 @@ const passes = await client.simulateCheckGate({
 console.log("User passes gate:", passes);
 ```
 
+If you initialize with an authority different from the provider wallet, pass `authoritySigner`:
+
+```typescript
+await client.initializeGate({
+  gateId,
+  criteria,
+  gateType,
+  authority: externalAuthority.publicKey,
+  authoritySigner: externalAuthority,
+});
+```
+
 ---
 
 ## Gate Criteria
 
+For criteria that rely on `remaining_accounts` on-chain (`MultiDao`, `NftCollection`, `CustomProgram`), pass those accounts with `checkGate({ remainingAccounts: [...] })`.
+
 ### `MinReputation`
 Require a minimum Vine reputation score for a season.
 ```typescript
@@ -127,6 +141,18 @@ GateCriteriaFactory.multiDao({
 })
 ```
 
+```typescript
+await client.checkGate({
+  gateId,
+  user: userWallet,
+  remainingAccounts: [
+    { pubkey: checkRecordA, isWritable: false, isSigner: false },
+    { pubkey: checkRecordB, isWritable: false, isSigner: false },
+    { pubkey: checkRecordC, isWritable: false, isSigner: false },
+  ],
+});
+```
+
 ### `TokenHolding`
 Require holding a minimum amount of a specific token.
 ```typescript
@@ -146,6 +172,39 @@ GateCriteriaFactory.nftCollection({
 })
 ```
 
+```typescript
+await client.checkGate({
+  gateId,
+  user: userWallet,
+  remainingAccounts: metadataAccounts.map((pubkey) => ({
+    pubkey,
+    isWritable: false,
+    isSigner: false,
+  })),
+});
+```
+
+### `CustomProgram`
+Require a validation account from another program. The SDK expects a 32-byte instruction hash.
+```typescript
+import { createHash } from "crypto";
+
+const instructionDataHash = createHash("sha256").update(myInstructionBytes).digest();
+
+GateCriteriaFactory.customProgram({
+  programId: myProgramId,
+  instructionDataHash, // must be 32 bytes
+});
+
+await client.checkGate({
+  gateId,
+  user: userWallet,
+  remainingAccounts: [
+    { pubkey: customValidationAccount, isWritable: false, isSigner: false },
+  ],
+});
+```
+
 ---
 
 ## Gate Types
@@ -168,7 +227,7 @@ import {
   findVineReputationPda,
   findGrapeIdentityPda,
   findGrapeLinkPda,
-} from "@grape-protocol/gpass-sdk";
+} from "@grapenpm/gpass-sdk";
 
 // Gate PDA
 const [gatePda] = await findGatePda(gateId);

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { Program, AnchorProvider } from '@coral-xyz/anchor';
-import { PublicKey, TransactionInstruction, Transaction } from '@solana/web3.js';
+import { PublicKey, AccountMeta, Signer, TransactionInstruction, Transaction } from '@solana/web3.js';
 import BN from 'bn.js';
 
 type GrapeGatingProtocol = {
@@ -844,7 +844,15 @@ declare const GateCriteriaFactory: {
     }) => GateCriteria;
     customProgram: (params: {
         programId: PublicKey;
-        instructionData?: Buffer;
+        /**
+         * 32-byte hash expected by the on-chain validation account.
+         * Prefer this field.
+         */
+        instructionDataHash?: Buffer | Uint8Array;
+        /**
+         * @deprecated Use instructionDataHash.
+         */
+        instructionData?: Buffer | Uint8Array;
     }) => GateCriteria;
 };
 interface Gate {
@@ -874,6 +882,11 @@ interface InitializeGateParams {
     gateType: GateType;
     /** Defaults to the provider wallet */
     authority?: PublicKey;
+    /**
+     * Required if authority is not the provider wallet.
+     * This signer must correspond to `authority`.
+     */
+    authoritySigner?: Signer;
 }
 interface CheckGateParams {
     gateId: PublicKey;
@@ -888,6 +901,12 @@ interface CheckGateParams {
     tokenAccount?: PublicKey;
     /** If true, creates/updates a GateCheckRecord PDA on-chain */
     storeRecord?: boolean;
+    /**
+     * Extra accounts forwarded to the instruction.
+     * Required for criteria that read `remaining_accounts`
+     * (e.g. MultiDao, NftCollection, CustomProgram).
+     */
+    remainingAccounts?: AccountMeta[];
 }
 interface UpdateGateCriteriaParams {
     gateId: PublicKey;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { Program, AnchorProvider } from '@coral-xyz/anchor';
-import { PublicKey, TransactionInstruction, Transaction } from '@solana/web3.js';
+import { PublicKey, AccountMeta, Signer, TransactionInstruction, Transaction } from '@solana/web3.js';
 import BN from 'bn.js';
 
 type GrapeGatingProtocol = {
@@ -844,7 +844,15 @@ declare const GateCriteriaFactory: {
     }) => GateCriteria;
     customProgram: (params: {
         programId: PublicKey;
-        instructionData?: Buffer;
+        /**
+         * 32-byte hash expected by the on-chain validation account.
+         * Prefer this field.
+         */
+        instructionDataHash?: Buffer | Uint8Array;
+        /**
+         * @deprecated Use instructionDataHash.
+         */
+        instructionData?: Buffer | Uint8Array;
     }) => GateCriteria;
 };
 interface Gate {
@@ -874,6 +882,11 @@ interface InitializeGateParams {
     gateType: GateType;
     /** Defaults to the provider wallet */
     authority?: PublicKey;
+    /**
+     * Required if authority is not the provider wallet.
+     * This signer must correspond to `authority`.
+     */
+    authoritySigner?: Signer;
 }
 interface CheckGateParams {
     gateId: PublicKey;
@@ -888,6 +901,12 @@ interface CheckGateParams {
     tokenAccount?: PublicKey;
     /** If true, creates/updates a GateCheckRecord PDA on-chain */
     storeRecord?: boolean;
+    /**
+     * Extra accounts forwarded to the instruction.
+     * Required for criteria that read `remaining_accounts`
+     * (e.g. MultiDao, NftCollection, CustomProgram).
+     */
+    remainingAccounts?: AccountMeta[];
 }
 interface UpdateGateCriteriaParams {
     gateId: PublicKey;