aavegotchi-cli 0.1.0 → 0.2.0

package/dist/schemas.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.batchPlanSchema = exports.batchStepSchema = exports.legacyCliConfigSchema = exports.cliConfigSchema = exports.profileSchema = exports.policySchema = exports.signerSchema = void 0;
+exports.gbmBidSchema = exports.gbmAuctionSchema = exports.baazaarErc1155ListingSchema = exports.baazaarErc721ListingSchema = exports.subgraphVariablesSchema = exports.batchPlanSchema = exports.batchStepSchema = exports.legacyCliConfigSchema = exports.cliConfigSchema = exports.profileSchema = exports.policySchema = exports.signerSchema = void 0;
 const zod_1 = require("zod");
 const addressSchema = zod_1.z
     .string()
@@ -77,3 +77,61 @@ exports.batchPlanSchema = zod_1.z.object({
     continueOnError: zod_1.z.boolean().optional(),
     steps: zod_1.z.array(exports.batchStepSchema).min(1),
 });
+exports.subgraphVariablesSchema = zod_1.z.object({}).catchall(zod_1.z.unknown());
+exports.baazaarErc721ListingSchema = zod_1.z.object({
+    id: zod_1.z.union([zod_1.z.string(), zod_1.z.number()]).transform((value) => String(value)),
+    category: zod_1.z.union([zod_1.z.string(), zod_1.z.number()]).transform((value) => String(value)),
+    erc721TokenAddress: addressSchema,
+    tokenId: zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.bigint()]).transform((value) => String(value)),
+    seller: addressSchema,
+    priceInWei: zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.bigint()]).transform((value) => String(value)),
+    cancelled: zod_1.z.boolean(),
+    timeCreated: zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.bigint()]).transform((value) => String(value)),
+    timePurchased: zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.bigint()]).transform((value) => String(value)),
+});
+exports.baazaarErc1155ListingSchema = zod_1.z.object({
+    id: zod_1.z.union([zod_1.z.string(), zod_1.z.number()]).transform((value) => String(value)),
+    category: zod_1.z.union([zod_1.z.string(), zod_1.z.number()]).transform((value) => String(value)),
+    erc1155TokenAddress: addressSchema,
+    erc1155TypeId: zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.bigint()]).transform((value) => String(value)),
+    quantity: zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.bigint()]).transform((value) => String(value)),
+    seller: addressSchema,
+    priceInWei: zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.bigint()]).transform((value) => String(value)),
+    cancelled: zod_1.z.boolean(),
+    sold: zod_1.z.boolean(),
+    timeCreated: zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.bigint()]).transform((value) => String(value)),
+});
+exports.gbmAuctionSchema = zod_1.z.object({
+    id: zod_1.z.union([zod_1.z.string(), zod_1.z.number()]).transform((value) => String(value)),
+    type: zod_1.z.string().optional(),
+    contractAddress: addressSchema,
+    tokenId: zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.bigint()]).transform((value) => String(value)),
+    quantity: zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.bigint()]).transform((value) => String(value)),
+    seller: addressSchema,
+    highestBid: zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.bigint()]).transform((value) => String(value)),
+    highestBidder: addressSchema.optional(),
+    totalBids: zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.bigint()]).transform((value) => String(value)),
+    startsAt: zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.bigint()]).transform((value) => String(value)),
+    endsAt: zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.bigint()]).transform((value) => String(value)),
+    claimAt: zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.bigint()]).transform((value) => String(value)).optional(),
+    claimed: zod_1.z.boolean(),
+    cancelled: zod_1.z.boolean(),
+    presetId: zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.bigint()]).transform((value) => String(value)).optional(),
+    category: zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.bigint()]).transform((value) => String(value)).optional(),
+    buyNowPrice: zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.bigint()]).transform((value) => String(value)).optional(),
+    startBidPrice: zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.bigint()]).transform((value) => String(value)).optional(),
+});
+exports.gbmBidSchema = zod_1.z.object({
+    id: zod_1.z.union([zod_1.z.string(), zod_1.z.number()]).transform((value) => String(value)),
+    bidder: addressSchema,
+    amount: zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.bigint()]).transform((value) => String(value)),
+    bidTime: zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.bigint()]).transform((value) => String(value)),
+    outbid: zod_1.z.boolean(),
+    previousBid: zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.bigint()]).transform((value) => String(value)).optional(),
+    previousBidder: addressSchema.optional(),
+    auction: zod_1.z
+        .object({
+        id: zod_1.z.union([zod_1.z.string(), zod_1.z.number()]).transform((value) => String(value)),
+    })
+        .optional(),
+});

package/dist/subgraph/client.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeSubgraphQuery = executeSubgraphQuery;
+const errors_1 = require("../errors");
+const sources_1 = require("./sources");
+const DEFAULT_TIMEOUT_MS = 10000;
+const DEFAULT_RETRIES = 1;
+const DEFAULT_AUTH_ENV_VAR = "GOLDSKY_API_KEY";
+function ensureAuthEnvVarName(value) {
+    if (!/^[A-Z_][A-Z0-9_]*$/.test(value)) {
+        throw new errors_1.CliError("INVALID_ARGUMENT", `Invalid auth env var '${value}'.`, 2, {
+            authEnvVar: value,
+        });
+    }
+    return value;
+}
+async function fetchWithTimeout(url, init, timeoutMs, details) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        return await fetch(url, {
+            ...init,
+            signal: controller.signal,
+        });
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === "AbortError") {
+            throw new errors_1.CliError("SUBGRAPH_TIMEOUT", `Subgraph query timed out after ${timeoutMs}ms.`, 2, {
+                ...details,
+                timeoutMs,
+            });
+        }
+        throw new errors_1.CliError("SUBGRAPH_HTTP_ERROR", "Failed to reach subgraph endpoint.", 2, {
+            ...details,
+            message: error instanceof Error ? error.message : String(error),
+        });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function parseGraphQlPayload(raw, details) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new errors_1.CliError("SUBGRAPH_INVALID_RESPONSE", "Subgraph response was not valid JSON.", 2, details);
+    }
+    if (!parsed || typeof parsed !== "object") {
+        throw new errors_1.CliError("SUBGRAPH_INVALID_RESPONSE", "Subgraph response shape is invalid.", 2, details);
+    }
+    return parsed;
+}
+function isRetriableError(error) {
+    return error.code === "SUBGRAPH_TIMEOUT" || error.code === "SUBGRAPH_HTTP_ERROR";
+}
+async function executeSubgraphQuery(options) {
+    const resolved = (0, sources_1.resolveSubgraphEndpoint)({
+        source: options.source,
+        subgraphUrl: options.subgraphUrl,
+        allowUntrustedSubgraph: options.allowUntrustedSubgraph,
+    });
+    const authEnvVar = ensureAuthEnvVarName(options.authEnvVar || DEFAULT_AUTH_ENV_VAR);
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    if (!Number.isInteger(timeoutMs) || timeoutMs <= 0) {
+        throw new errors_1.CliError("INVALID_ARGUMENT", "--timeout-ms must be a positive integer.", 2, {
+            timeoutMs,
+        });
+    }
+    const retries = DEFAULT_RETRIES;
+    const headers = {
+        "content-type": "application/json",
+    };
+    const authToken = process.env[authEnvVar];
+    if (authToken) {
+        headers.authorization = `Bearer ${authToken}`;
+    }
+    const requestBody = JSON.stringify({
+        query: options.query,
+        variables: options.variables || {},
+    });
+    const requestDetails = {
+        source: resolved.source,
+        endpoint: resolved.endpoint,
+        queryName: options.queryName,
+    };
+    let lastError;
+    for (let attempt = 0; attempt <= retries; attempt++) {
+        try {
+            const response = await fetchWithTimeout(resolved.endpoint, {
+                method: "POST",
+                headers,
+                body: requestBody,
+            }, timeoutMs, requestDetails);
+            const responseText = await response.text();
+            if (!response.ok) {
+                throw new errors_1.CliError("SUBGRAPH_HTTP_ERROR", `Subgraph endpoint returned HTTP ${response.status}.`, 2, {
+                    ...requestDetails,
+                    status: response.status,
+                    body: responseText.slice(0, 500),
+                });
+            }
+            const payload = parseGraphQlPayload(responseText, requestDetails);
+            if (Array.isArray(payload.errors) && payload.errors.length > 0) {
+                throw new errors_1.CliError("SUBGRAPH_GRAPHQL_ERROR", "Subgraph query returned GraphQL errors.", 2, {
+                    ...requestDetails,
+                    errors: payload.errors,
+                });
+            }
+            if (!("data" in payload)) {
+                throw new errors_1.CliError("SUBGRAPH_INVALID_RESPONSE", "Subgraph response missing 'data' field.", 2, requestDetails);
+            }
+            return {
+                source: resolved.source,
+                endpoint: resolved.endpoint,
+                queryName: options.queryName,
+                data: payload.data,
+                ...(options.raw ? { raw: payload } : {}),
+            };
+        }
+        catch (error) {
+            if (error instanceof errors_1.CliError) {
+                lastError = error;
+                if (attempt < retries && isRetriableError(error)) {
+                    continue;
+                }
+                throw error;
+            }
+            lastError = new errors_1.CliError("SUBGRAPH_HTTP_ERROR", "Subgraph request failed.", 2, {
+                ...requestDetails,
+                message: error instanceof Error ? error.message : String(error),
+            });
+            if (attempt < retries) {
+                continue;
+            }
+            throw lastError;
+        }
+    }
+    throw (lastError ||
+        new errors_1.CliError("SUBGRAPH_HTTP_ERROR", "Subgraph request failed.", 2, {
+            ...requestDetails,
+        }));
+}

package/dist/subgraph/normalize.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toLowercaseAddress = toLowercaseAddress;
+exports.normalizeBaazaarErc721Listing = normalizeBaazaarErc721Listing;
+exports.normalizeBaazaarErc1155Listing = normalizeBaazaarErc1155Listing;
+exports.normalizeGbmAuction = normalizeGbmAuction;
+exports.normalizeGbmBid = normalizeGbmBid;
+exports.normalizeBaazaarErc721Listings = normalizeBaazaarErc721Listings;
+exports.normalizeBaazaarErc1155Listings = normalizeBaazaarErc1155Listings;
+exports.normalizeGbmAuctions = normalizeGbmAuctions;
+exports.normalizeGbmBids = normalizeGbmBids;
+const schemas_1 = require("../schemas");
+const errors_1 = require("../errors");
+function toNormalizeError(message, details) {
+    return new errors_1.CliError("SUBGRAPH_INVALID_RESPONSE", message, 2, details);
+}
+function toLowercaseAddress(value) {
+    if (!/^0x[a-fA-F0-9]{40}$/.test(value)) {
+        throw toNormalizeError("Subgraph response includes invalid address.", {
+            value,
+        });
+    }
+    return value.toLowerCase();
+}
+function parseWithSchema(name, value, parser) {
+    try {
+        return parser.parse(value);
+    }
+    catch (error) {
+        throw toNormalizeError(`Failed to parse subgraph payload for ${name}.`, {
+            name,
+            message: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+function normalizeBaazaarErc721Listing(value) {
+    const parsed = parseWithSchema("erc721Listing", value, schemas_1.baazaarErc721ListingSchema);
+    return {
+        ...parsed,
+        erc721TokenAddress: toLowercaseAddress(parsed.erc721TokenAddress),
+        seller: toLowercaseAddress(parsed.seller),
+    };
+}
+function normalizeBaazaarErc1155Listing(value) {
+    const parsed = parseWithSchema("erc1155Listing", value, schemas_1.baazaarErc1155ListingSchema);
+    return {
+        ...parsed,
+        erc1155TokenAddress: toLowercaseAddress(parsed.erc1155TokenAddress),
+        seller: toLowercaseAddress(parsed.seller),
+    };
+}
+function normalizeGbmAuction(value) {
+    const parsed = parseWithSchema("auction", value, schemas_1.gbmAuctionSchema);
+    return {
+        ...parsed,
+        contractAddress: toLowercaseAddress(parsed.contractAddress),
+        seller: toLowercaseAddress(parsed.seller),
+        ...(parsed.highestBidder ? { highestBidder: toLowercaseAddress(parsed.highestBidder) } : {}),
+    };
+}
+function normalizeGbmBid(value) {
+    const parsed = parseWithSchema("bid", value, schemas_1.gbmBidSchema);
+    return {
+        id: parsed.id,
+        bidder: toLowercaseAddress(parsed.bidder),
+        amount: parsed.amount,
+        bidTime: parsed.bidTime,
+        outbid: parsed.outbid,
+        ...(parsed.previousBid ? { previousBid: parsed.previousBid } : {}),
+        ...(parsed.previousBidder ? { previousBidder: toLowercaseAddress(parsed.previousBidder) } : {}),
+        ...(parsed.auction?.id ? { auctionId: parsed.auction.id } : {}),
+    };
+}
+function normalizeBaazaarErc721Listings(values) {
+    return values.map((value) => normalizeBaazaarErc721Listing(value));
+}
+function normalizeBaazaarErc1155Listings(values) {
+    return values.map((value) => normalizeBaazaarErc1155Listing(value));
+}
+function normalizeGbmAuctions(values) {
+    return values.map((value) => normalizeGbmAuction(value));
+}
+function normalizeGbmBids(values) {
+    return values.map((value) => normalizeGbmBid(value));
+}

package/dist/subgraph/queries.js

@@ -0,0 +1,256 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GBM_BIDS_BY_BIDDER_QUERY = exports.GBM_BIDS_BY_AUCTION_QUERY = exports.GBM_MINE_AUCTIONS_QUERY = exports.GBM_ACTIVE_AUCTIONS_QUERY = exports.GBM_AUCTION_BY_ID_QUERY = exports.BAAZAAR_MINE_ERC1155_QUERY = exports.BAAZAAR_MINE_ERC721_QUERY = exports.BAAZAAR_ACTIVE_ERC1155_QUERY = exports.BAAZAAR_ACTIVE_ERC721_QUERY = exports.BAAZAAR_ERC1155_LISTING_BY_ID_QUERY = exports.BAAZAAR_ERC721_LISTING_BY_ID_QUERY = exports.SUBGRAPH_INTROSPECTION_QUERY = void 0;
+exports.SUBGRAPH_INTROSPECTION_QUERY = `
+query {
+  __schema {
+    queryType {
+      fields {
+        name
+      }
+    }
+  }
+}
+`.trim();
+exports.BAAZAAR_ERC721_LISTING_BY_ID_QUERY = `
+query($id: ID!) {
+  erc721Listing(id: $id) {
+    id
+    category
+    erc721TokenAddress
+    tokenId
+    seller
+    priceInWei
+    cancelled
+    timeCreated
+    timePurchased
+  }
+}
+`.trim();
+exports.BAAZAAR_ERC1155_LISTING_BY_ID_QUERY = `
+query($id: ID!) {
+  erc1155Listing(id: $id) {
+    id
+    category
+    erc1155TokenAddress
+    erc1155TypeId
+    quantity
+    seller
+    priceInWei
+    cancelled
+    sold
+    timeCreated
+  }
+}
+`.trim();
+exports.BAAZAAR_ACTIVE_ERC721_QUERY = `
+query($first: Int!, $skip: Int!) {
+  erc721Listings(
+    first: $first
+    skip: $skip
+    orderBy: timeCreated
+    orderDirection: desc
+    where: { cancelled: false, timePurchased: "0" }
+  ) {
+    id
+    category
+    erc721TokenAddress
+    tokenId
+    seller
+    priceInWei
+    cancelled
+    timeCreated
+    timePurchased
+  }
+}
+`.trim();
+exports.BAAZAAR_ACTIVE_ERC1155_QUERY = `
+query($first: Int!, $skip: Int!) {
+  erc1155Listings(
+    first: $first
+    skip: $skip
+    orderBy: timeCreated
+    orderDirection: desc
+    where: { cancelled: false, sold: false }
+  ) {
+    id
+    category
+    erc1155TokenAddress
+    erc1155TypeId
+    quantity
+    seller
+    priceInWei
+    cancelled
+    sold
+    timeCreated
+  }
+}
+`.trim();
+exports.BAAZAAR_MINE_ERC721_QUERY = `
+query($seller: Bytes!, $first: Int!, $skip: Int!) {
+  erc721Listings(
+    first: $first
+    skip: $skip
+    orderBy: timeCreated
+    orderDirection: desc
+    where: { seller: $seller }
+  ) {
+    id
+    category
+    erc721TokenAddress
+    tokenId
+    seller
+    priceInWei
+    cancelled
+    timeCreated
+    timePurchased
+  }
+}
+`.trim();
+exports.BAAZAAR_MINE_ERC1155_QUERY = `
+query($seller: Bytes!, $first: Int!, $skip: Int!) {
+  erc1155Listings(
+    first: $first
+    skip: $skip
+    orderBy: timeCreated
+    orderDirection: desc
+    where: { seller: $seller }
+  ) {
+    id
+    category
+    erc1155TokenAddress
+    erc1155TypeId
+    quantity
+    seller
+    priceInWei
+    cancelled
+    sold
+    timeCreated
+  }
+}
+`.trim();
+exports.GBM_AUCTION_BY_ID_QUERY = `
+query($id: ID!) {
+  auction(id: $id) {
+    id
+    type
+    contractAddress
+    tokenId
+    quantity
+    seller
+    highestBid
+    highestBidder
+    totalBids
+    startsAt
+    endsAt
+    claimAt
+    claimed
+    cancelled
+    presetId
+    category
+    buyNowPrice
+    startBidPrice
+  }
+}
+`.trim();
+exports.GBM_ACTIVE_AUCTIONS_QUERY = `
+query($now: BigInt!, $first: Int!, $skip: Int!) {
+  auctions(
+    first: $first
+    skip: $skip
+    orderBy: endsAt
+    orderDirection: asc
+    where: { claimed: false, cancelled: false, startsAt_lte: $now, endsAt_gt: $now }
+  ) {
+    id
+    type
+    contractAddress
+    tokenId
+    quantity
+    seller
+    highestBid
+    highestBidder
+    totalBids
+    startsAt
+    endsAt
+    claimAt
+    claimed
+    cancelled
+    presetId
+    category
+    buyNowPrice
+    startBidPrice
+  }
+}
+`.trim();
+exports.GBM_MINE_AUCTIONS_QUERY = `
+query($seller: Bytes!, $first: Int!, $skip: Int!) {
+  auctions(
+    first: $first
+    skip: $skip
+    orderBy: createdAt
+    orderDirection: desc
+    where: { seller: $seller }
+  ) {
+    id
+    type
+    contractAddress
+    tokenId
+    quantity
+    seller
+    highestBid
+    highestBidder
+    totalBids
+    startsAt
+    endsAt
+    claimAt
+    claimed
+    cancelled
+    presetId
+    category
+    buyNowPrice
+    startBidPrice
+  }
+}
+`.trim();
+exports.GBM_BIDS_BY_AUCTION_QUERY = `
+query($auctionId: String!, $first: Int!, $skip: Int!) {
+  bids(
+    first: $first
+    skip: $skip
+    orderBy: bidTime
+    orderDirection: desc
+    where: { auction: $auctionId }
+  ) {
+    id
+    bidder
+    amount
+    bidTime
+    outbid
+    previousBid
+    previousBidder
+  }
+}
+`.trim();
+exports.GBM_BIDS_BY_BIDDER_QUERY = `
+query($bidder: Bytes!, $first: Int!, $skip: Int!) {
+  bids(
+    first: $first
+    skip: $skip
+    orderBy: bidTime
+    orderDirection: desc
+    where: { bidder: $bidder }
+  ) {
+    id
+    bidder
+    amount
+    bidTime
+    outbid
+    previousBid
+    previousBidder
+    auction {
+      id
+    }
+  }
+}
+`.trim();

package/dist/subgraph/sources.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BASE_GBM_DIAMOND = exports.BASE_AAVEGOTCHI_DIAMOND = exports.GBM_BASE_ENDPOINT = exports.CORE_BASE_ENDPOINT = void 0;
+exports.listSubgraphSources = listSubgraphSources;
+exports.parseSubgraphSourceAlias = parseSubgraphSourceAlias;
+exports.resolveSubgraphEndpoint = resolveSubgraphEndpoint;
+const errors_1 = require("../errors");
+exports.CORE_BASE_ENDPOINT = "https://api.goldsky.com/api/public/project_cmh3flagm0001r4p25foufjtt/subgraphs/aavegotchi-core-base/prod/gn";
+exports.GBM_BASE_ENDPOINT = "https://api.goldsky.com/api/public/project_cmh3flagm0001r4p25foufjtt/subgraphs/aavegotchi-gbm-baazaar-base/prod/gn";
+exports.BASE_AAVEGOTCHI_DIAMOND = "0xa99c4b08201f2913db8d28e71d020c4298f29dbf";
+exports.BASE_GBM_DIAMOND = "0x80320a0000c7a6a34086e2acad6915ff57ffda31";
+const SOURCE_MAP = {
+    "core-base": {
+        alias: "core-base",
+        endpoint: exports.CORE_BASE_ENDPOINT,
+        description: "Aavegotchi core base subgraph (Baazaar listings and core entities).",
+    },
+    "gbm-base": {
+        alias: "gbm-base",
+        endpoint: exports.GBM_BASE_ENDPOINT,
+        description: "Aavegotchi GBM baazaar base subgraph (auctions and bids).",
+    },
+};
+function listSubgraphSources() {
+    return Object.values(SOURCE_MAP);
+}
+function parseSubgraphSourceAlias(value) {
+    if (!value) {
+        throw new errors_1.CliError("MISSING_ARGUMENT", "subgraph source is required (--source).", 2);
+    }
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "core-base" || normalized === "gbm-base") {
+        return normalized;
+    }
+    throw new errors_1.CliError("SUBGRAPH_SOURCE_UNKNOWN", `Unknown subgraph source '${value}'.`, 2, {
+        source: value,
+        supportedSources: Object.keys(SOURCE_MAP),
+    });
+}
+function parseHttpsUrl(value) {
+    let parsed;
+    try {
+        parsed = new URL(value);
+    }
+    catch {
+        throw new errors_1.CliError("INVALID_ARGUMENT", "subgraph url must be a valid URL.", 2, {
+            subgraphUrl: value,
+        });
+    }
+    if (parsed.protocol !== "https:") {
+        throw new errors_1.CliError("SUBGRAPH_ENDPOINT_BLOCKED", "Custom subgraph url must use HTTPS.", 2, {
+            subgraphUrl: value,
+        });
+    }
+    return parsed.toString();
+}
+function resolveSubgraphEndpoint(input) {
+    const source = SOURCE_MAP[input.source];
+    if (!source) {
+        throw new errors_1.CliError("SUBGRAPH_SOURCE_UNKNOWN", `Unknown subgraph source '${input.source}'.`, 2, {
+            source: input.source,
+            supportedSources: Object.keys(SOURCE_MAP),
+        });
+    }
+    if (!input.subgraphUrl) {
+        return {
+            source: source.alias,
+            endpoint: source.endpoint,
+            isCustomEndpoint: false,
+        };
+    }
+    const endpoint = parseHttpsUrl(input.subgraphUrl);
+    if (endpoint === source.endpoint) {
+        return {
+            source: source.alias,
+            endpoint,
+            isCustomEndpoint: false,
+        };
+    }
+    if (!input.allowUntrustedSubgraph) {
+        throw new errors_1.CliError("SUBGRAPH_ENDPOINT_BLOCKED", "Custom subgraph endpoint blocked by default. Pass --allow-untrusted-subgraph to override.", 2, {
+            source: source.alias,
+            canonicalEndpoint: source.endpoint,
+            requestedEndpoint: endpoint,
+        });
+    }
+    return {
+        source: source.alias,
+        endpoint,
+        isCustomEndpoint: true,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aavegotchi-cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Agent-first CLI for automating Aavegotchi app and onchain workflows",
   "license": "MIT",
   "repository": {
@@ -11,7 +11,8 @@
   "main": "dist/index.js",
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "bin": {
     "ag": "dist/index.js",