easctl 0.2.0 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "easctl",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "CLI tool for the Ethereum Attestation Service — create, revoke, and query attestations from the command line",
   "bin": {
     "easctl": "./dist/index.js"

package/src/__tests__/commands/query-attestations.test.ts

@@ -5,6 +5,7 @@ vi.mock('../../graphql.js', () => ({
   QUERIES: {
     getAttestationsBySchema: 'query BySchema',
     getAttestationsByAttester: 'query ByAttester',
+    getAttestationsByRecipient: 'query ByRecipient',
   },
 }));
 
@@ -62,6 +63,20 @@ describe('query-attestations command', () => {
     });
   });
 
+  it('queries by recipient', async () => {
+    (graphqlQuery as any).mockResolvedValue({
+      attestations: [{ id: '0x1' }],
+    });
+
+    await runCommand(['-r', '0xRecipient']);
+
+    expect(graphqlQuery).toHaveBeenCalledWith('ethereum', QUERIES.getAttestationsByRecipient, {
+      recipient: '0xRecipient',
+      take: 10,
+      skip: 0,
+    });
+  });
+
   it('passes skip for pagination', async () => {
     (graphqlQuery as any).mockResolvedValue({ attestations: [] });
 

package/src/__tests__/integration/graphql-live.test.ts

@@ -65,6 +65,16 @@ describe('GraphQL live queries (sepolia)', () => {
     expect(Array.isArray(data.attestations)).toBe(true);
   });
 
+  it('getAttestationsByRecipient returns attestations array', async () => {
+    const data = await graphqlQuery(chain, QUERIES.getAttestationsByRecipient, {
+      recipient: '0x0000000000000000000000000000000000000000',
+      take: 1,
+    });
+
+    expect(data.attestations).toBeDefined();
+    expect(Array.isArray(data.attestations)).toBe(true);
+  });
+
   it('getAttestation returns a single attestation with all expected fields', async () => {
     // First get a real attestation ID by querying recent attestations by a known schema
     // We use getSchemata to find a schema, then query its attestations

package/src/commands/query-attestations.ts

@@ -7,16 +7,18 @@ export const queryAttestationsCommand = new Command('query-attestations')
   .description('Query attestations by schema or attester from the EAS GraphQL API')
   .option('-s, --schema <uid>', 'Filter by schema UID or popular schema name')
   .option('-a, --attester <address>', 'Filter by attester address')
+  .option('-r, --recipient <address>', 'Filter by recipient address')
   .option('-n, --limit <number>', 'Max results to return', '10')
   .option('--skip <number>', 'Number of results to skip (for pagination)', '0')
   .option('-c, --chain <name>', 'Chain name', 'ethereum')
   .action(async (opts) => {
     try {
-      if (!opts.schema && !opts.attester) {
-        throw new Error('Provide at least one filter: --schema or --attester');
+      if (!opts.schema && !opts.attester && !opts.recipient) {
+        throw new Error('Provide at least one filter: --schema, --attester, or --recipient');
       }
       if (opts.schema) opts.schema = resolveAndValidateSchemaUID(opts.schema, 'schema UID');
       if (opts.attester) validateAddress(opts.attester, 'attester');
+      if (opts.recipient) validateAddress(opts.recipient, 'recipient');
 
       const take = parseInt(opts.limit, 10);
       const skip = parseInt(opts.skip, 10);
@@ -30,12 +32,18 @@ export const queryAttestationsCommand = new Command('query-attestations')
           take,
           skip,
         });
-      } else {
+      } else if (opts.attester) {
         data = await graphqlQuery(opts.chain, QUERIES.getAttestationsByAttester, {
           attester: opts.attester,
           take,
           skip,
         });
+      } else {
+        data = await graphqlQuery(opts.chain, QUERIES.getAttestationsByRecipient, {
+          recipient: opts.recipient,
+          take,
+          skip,
+        });
       }
 
       const attestations = data.attestations || [];

package/src/graphql.ts

@@ -117,6 +117,24 @@ export const QUERIES = {
       }
     }
   `,
+  getAttestationsByRecipient: `
+    query GetAttestationsByRecipient($recipient: String!, $take: Int, $skip: Int) {
+      attestations(
+        where: { recipient: { equals: $recipient } }
+        take: $take
+        skip: $skip
+        orderBy: [{ time: desc }]
+      ) {
+        id
+        attester
+        schemaId
+        time
+        revoked
+        decodedDataJson
+        isOffchain
+      }
+    }
+  `,
   getSchemata: `
     query GetSchemata($take: Int, $skip: Int) {
       schemata(