feat: add verify signer sig

packages/stacking/README.md

@@ -80,6 +80,8 @@ const maxAmount = 100000000000n;
 // the auth id of the signer (a random id to not allow reusing the signature)
 const authId = 702;
 
+const signerPrivateKey = makeRandomPrivKey(); // replace with your signer private key
+
 const signature = client.signPoxSignature({
   topic: 'stack-stx', // the topic of the transaction
   poxAddress,
@@ -92,7 +94,7 @@ const signature = client.signPoxSignature({
 ```
 
 > [!WARNING]
-> Make sure to replace `signerPrivateKey` with the signer private key of your setup.
+> Make sure to replace `signerPrivateKey` with the signer private key of your setup and keep it private.
 
 ### Topics
 

packages/stacking/src/index.ts

@@ -30,6 +30,7 @@ import {
   principalCV,
   principalToString,
   someCV,
+  stringAsciiCV,
   uintCV,
   validateStacksAddress,
 } from '@stacks/transactions';
@@ -1541,6 +1542,58 @@ export class StackingClient {
     });
   }
 
+  /**
+   * Call the `verify-signer-key-sig` read-only function on the PoX contract.
+   * @returns (async) a boolean indicating if the signature is valid
+   */
+  async verifySignerKeySignature({
+    topic,
+    poxAddress,
+    rewardCycle,
+    period,
+    signerSignature,
+    signerKey,
+    amount,
+    maxAmount,
+    authId,
+  }: {
+    topic: string;
+    poxAddress: string;
+    rewardCycle: number;
+    period: number;
+    signerSignature?: string;
+    signerKey: string;
+    amount: IntegerType;
+    maxAmount: IntegerType;
+    authId: IntegerType;
+  }): Promise<boolean> {
+    const poxInfo = await this.getPoxInfo();
+
+    const [contractAddress, contractName] = this.parseContractId(poxInfo.contract_id);
+    const functionName = 'verify-signer-key-sig';
+
+    const functionArgs = [
+      poxAddressToTuple(poxAddress),
+      uintCV(rewardCycle),
+      stringAsciiCV(topic),
+      uintCV(period),
+      signerSignature ? someCV(bufferCV(hexToBytes(signerSignature))) : noneCV(),
+      bufferCV(hexToBytes(signerKey)),
+      uintCV(amount),
+      uintCV(maxAmount),
+      uintCV(authId),
+    ];
+
+    return callReadOnlyFunction({
+      contractAddress,
+      contractName,
+      functionName,
+      functionArgs,
+      network: this.network,
+      senderAddress: this.address,
+    }).then(responseCV => responseCV.type === ClarityType.ResponseOk);
+  }
+
   /**
    * @returns {Promise<string>} that resolves to the contract id (address and name) to use for stacking
    */