easctl 0.2.0 → 0.2.1

package/README.md

@@ -2,7 +2,7 @@
 
 Command-line interface for the [Ethereum Attestation Service](https://attest.org). Built on [EAS SDK v2](https://github.com/ethereum-attestation-service/eas-sdk-v2) and [ethers](https://docs.ethers.org).
 
-All commands support `--json` for structured output and `--dry-run` for gas estimation without sending transactions.
+All commands support `--json` for structured output, `--dry-run` for gas estimation, and popular schema names (e.g. `--schema make-a-statement`) instead of raw UIDs.
 
 ## Installation
 
@@ -88,8 +88,24 @@ easctl schema-register --schema "uint256 score, string comment" --chain sepolia
 
 # Get a schema by UID (read-only)
 easctl schema-get --uid 0xSchemaUID --chain sepolia
+
+# Browse popular schemas
+easctl popular-schemas
+easctl popular-schemas --category social
+easctl popular-schemas --json
+```
+
+#### Popular Schema Names
+
+Instead of raw UIDs, you can use popular schema names anywhere a schema UID is accepted:
+
+```bash
+easctl attest --schema make-a-statement --data '[{"name":"statement","type":"string","value":"Hello EAS"}]'
+easctl query-attestations --schema is-a-friend --chain base
 ```
 
+Run `easctl popular-schemas` to see all available names.
+
 ### Timestamps
 
 ```bash
@@ -122,6 +138,10 @@ easctl query-schemas --creator 0xAddress --limit 20 --chain sepolia
 ### Utility
 
 ```bash
+# Show wallet, chain, and contract configuration
+easctl status
+easctl status --chain base
+
 # List supported chains
 easctl chains
 ```

package/dist/index.js

@@ -31164,6 +31164,24 @@ var 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(
@@ -31312,13 +31330,14 @@ var queryAttestationCommand = new import_commander10.Command("query-attestation"
 
 // src/commands/query-attestations.ts
 var import_commander11 = require("commander");
-var queryAttestationsCommand = new import_commander11.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("-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) => {
+var queryAttestationsCommand = new import_commander11.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);
     if (isNaN(take) || take < 1) throw new Error("--limit must be a positive integer");
@@ -31330,12 +31349,18 @@ var queryAttestationsCommand = new import_commander11.Command("query-attestation
         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 || [];
     for (const att of attestations) {
@@ -31555,7 +31580,7 @@ var statusCommand = new import_commander18.Command("status").description("Show c
 
 // src/index.ts
 var program = new import_commander19.Command();
-program.name("easctl").description("Ethereum Attestation Service CLI \u2014 create, revoke, and query attestations").version("0.2.0").option("--json", "Output results as JSON (useful for agents and scripting)").hook("preAction", (thisCommand, actionCommand) => {
+program.name("easctl").description("Ethereum Attestation Service CLI \u2014 create, revoke, and query attestations").version("0.2.1").option("--json", "Output results as JSON (useful for agents and scripting)").hook("preAction", (thisCommand, actionCommand) => {
   if (thisCommand.opts().json || actionCommand.opts().json) {
     setJsonMode(true);
   }