@agnocon/piece-blockscout 0.1.6

package/src/lib/actions/transactions/transaction-internal-transactions.ts

@@ -0,0 +1,28 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import { httpClient, HttpMethod } from '@agnocon/pieces-common';
+
+export const getTransactionInternalTransactions = createAction({
+  name: 'get_transaction_internal_transactions',
+  displayName: 'Get Transaction Internal Transactions',
+  description: 'Get list of internal transactions in a transaction',
+  audience: 'both',
+  aiMetadata: { description: 'List the internal transactions (value-transferring calls made by contracts, not separate top-level transactions) triggered within one Ethereum transaction, identified by its hash. Read-only. Use this to trace contract-to-contract ETH movement inside a single transaction; for ERC token movements in that transaction use Get Transaction Token Transfers instead.', idempotent: true },
+  // category: 'Transactions',
+  props: {
+    transactionHash: Property.ShortText({
+      displayName: 'Transaction Hash',
+      description: 'Hash of the transaction to fetch internal transactions for',
+      required: true,
+    }),
+  },
+  async run(context) {
+    const response = await httpClient.sendRequest({
+      method: HttpMethod.GET,
+      url: `https://eth.blockscout.com/api/v2/transactions/${context.propsValue.transactionHash}/internal-transactions`,
+    });
+    if (response.status !== 200) {
+      throw new Error(`Blockscout API request failed with status ${response.status}`);
+    }
+    return response.body;
+  },
+});

package/src/lib/actions/transactions/transaction-logs.ts

@@ -0,0 +1,28 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import { httpClient, HttpMethod } from '@agnocon/pieces-common';
+
+export const getTransactionLogs = createAction({
+  name: 'get_transaction_logs',
+  displayName: 'Get Transaction Logs',
+  description: 'Get list of logs generated by a transaction',
+  audience: 'both',
+  aiMetadata: { description: 'List the event logs emitted by one Ethereum transaction, identified by its hash (decoded contract events with topics and data). Read-only. Use this to inspect what events a transaction fired; for the resulting account/storage changes use Get Transaction State Changes instead.', idempotent: true },
+  // category: 'Transactions',
+  props: {
+    transactionHash: Property.ShortText({
+      displayName: 'Transaction Hash',
+      description: 'Hash of the transaction to fetch logs for',
+      required: true,
+    }),
+  },
+  async run(context) {
+    const response = await httpClient.sendRequest({
+      method: HttpMethod.GET,
+      url: `https://eth.blockscout.com/api/v2/transactions/${context.propsValue.transactionHash}/logs`,
+    });
+    if (response.status !== 200) {
+      throw new Error(`Blockscout API request failed with status ${response.status}`);
+    }
+    return response.body;
+  },
+});

package/src/lib/actions/transactions/transaction-raw-trace.ts

@@ -0,0 +1,28 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import { httpClient, HttpMethod } from '@agnocon/pieces-common';
+
+export const getTransactionRawTrace = createAction({
+  name: 'get_transaction_raw_trace',
+  displayName: 'Get Transaction Raw Trace',
+  description: 'Get raw trace data for a transaction',
+  audience: 'both',
+  aiMetadata: { description: 'Get the low-level raw execution trace (opcode-level call frames) for one Ethereum transaction by hash. Read-only and intended for deep debugging of contract execution. Prefer the higher-level Get Transaction Internal Transactions or Get Transaction by Hash actions for ordinary lookups; reach for this only when you need the full unprocessed trace.', idempotent: true },
+  // category: 'Transactions',
+  props: {
+    transactionHash: Property.ShortText({
+      displayName: 'Transaction Hash',
+      description: 'Hash of the transaction to fetch raw trace for',
+      required: true,
+    }),
+  },
+  async run(context) {
+    const response = await httpClient.sendRequest({
+      method: HttpMethod.GET,
+      url: `https://eth.blockscout.com/api/v2/transactions/${context.propsValue.transactionHash}/raw-trace`,
+    });
+    if (response.status !== 200) {
+      throw new Error(`Blockscout API request failed with status ${response.status}`);
+    }
+    return response.body;
+  },
+});

package/src/lib/actions/transactions/transaction-state-changes.ts

@@ -0,0 +1,28 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import { httpClient, HttpMethod } from '@agnocon/pieces-common';
+export const getTransactionStateChanges = createAction({
+  name: 'get_transaction_state_changes',
+  displayName: 'Get Transaction State Changes',
+  description: 'Get list of state changes in a transaction',
+  audience: 'both',
+  aiMetadata: { description: 'List the account balance and storage state changes (before/after values) caused by one Ethereum transaction, identified by its hash. Read-only. Use this to see how a transaction altered account or contract state; for the events it emitted use Get Transaction Logs instead.', idempotent: true },
+
+  // category: 'Transactions',
+  props: {
+    transactionHash: Property.ShortText({
+      displayName: 'Transaction Hash',
+      description: 'Hash of the transaction to fetch state changes for',
+      required: true,
+    }),
+  },
+  async run(context) {
+    const response = await httpClient.sendRequest({
+      method: HttpMethod.GET,
+      url: `https://eth.blockscout.com/api/v2/transactions/${context.propsValue.transactionHash}/state-changes`,
+    });
+    if (response.status !== 200) {
+      throw new Error(`Blockscout API request failed with status ${response.status}`);
+    }
+    return response.body;
+  },
+});

package/src/lib/actions/transactions/transaction-summary.ts

@@ -0,0 +1,28 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import { httpClient, HttpMethod } from '@agnocon/pieces-common';
+
+export const getTransactionSummary = createAction({
+  name: 'get_transaction_summary',
+  displayName: 'Get Transaction Summary',
+  description: 'Get a human-readable summary of a transaction',
+  audience: 'both',
+  aiMetadata: { description: "Get Blockscout's interpreted, human-readable summary of one Ethereum transaction by hash (e.g. a plain-language description of what the transaction did, such as a swap or transfer). Read-only. Use this for a quick natural-language explanation; for the structured raw fields use Get Transaction by Hash instead.", idempotent: true },
+  // category: 'Transactions',
+  props: {
+    transactionHash: Property.ShortText({
+      displayName: 'Transaction Hash',
+      description: 'Hash of the transaction to fetch summary for',
+      required: true,
+    }),
+  },
+  async run(context) {
+    const response = await httpClient.sendRequest({
+      method: HttpMethod.GET,
+      url: `https://eth.blockscout.com/api/v2/transactions/${context.propsValue.transactionHash}/summary`,
+    });
+    if (response.status !== 200) {
+      throw new Error(`Blockscout API request failed with status ${response.status}`);
+    }
+    return response.body;
+  },
+});

package/src/lib/actions/transactions/transaction-token-transfers.ts

@@ -0,0 +1,28 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import { httpClient, HttpMethod } from '@agnocon/pieces-common';
+
+export const getTransactionTokenTransfers = createAction({
+  name: 'get_transaction_token_transfers',
+  displayName: 'Get Transaction Token Transfers',
+  description: 'Get list of token transfers in a transaction',
+  audience: 'both',
+  aiMetadata: { description: 'List the ERC-20/721/1155 token transfers that occurred within one Ethereum transaction, identified by its hash. Read-only. Use this when you have a transaction hash and want the tokens it moved; for token transfers across a token contract over time use the Tokens Get Token Transfers action instead.', idempotent: true },
+  // category: 'Transactions',
+  props: {
+    transactionHash: Property.ShortText({
+      displayName: 'Transaction Hash',
+      description: 'Hash of the transaction to fetch token transfers for',
+      required: true,
+    }),
+  },
+  async run(context) {
+    const response = await httpClient.sendRequest({
+      method: HttpMethod.GET,
+      url: `https://eth.blockscout.com/api/v2/transactions/${context.propsValue.transactionHash}/token-transfers`,
+    });
+    if (response.status !== 200) {
+      throw new Error(`Blockscout API request failed with status ${response.status}`);
+    }
+    return response.body;
+  },
+});

package/src/lib/actions/transactions/transactions.ts

@@ -0,0 +1,22 @@
+import { createAction } from '@agnocon/pieces-framework';
+import { httpClient, HttpMethod } from '@agnocon/pieces-common';
+
+export const getTransactions = createAction({
+  name: 'get_transactions',
+  displayName: 'Get Transactions',
+  description: 'Get list of transactions',
+  audience: 'both',
+  aiMetadata: { description: 'List recent Ethereum transactions across the whole chain (validated mainnet transactions, newest first). Read-only and takes no inputs. Use this for chain-wide browsing; to fetch one known transaction use Get Transaction by Hash, and to scope to a single block use Get Block Transactions.', idempotent: true },
+  // category: 'Transactions',
+  props: {},
+  async run(context) {
+    const response = await httpClient.sendRequest({
+      method: HttpMethod.GET,
+      url: `https://eth.blockscout.com/api/v2/transactions`,
+    });
+    if (response.status !== 200) {
+      throw new Error(`Blockscout API request failed with status ${response.status}`);
+    }
+    return response.body;
+  },
+});