Add nova transactions command

api.ts

@@ -17,6 +17,7 @@ import {
   LinkCreatedResponse,
   RateLimited,
   TokenCreatedResponse,
+  TransactionsResponse,
   ValidationErrorResponse,
 } from "./responses/index.js";
 
@@ -51,6 +52,16 @@ class NovaApiClient {
     return Ok(validatedResponse);
   }
 
+  async getTransactions(address: string) {
+    const endpoint = AccountsEndpoints[this.network];
+    const response = await this.http
+      .get(`${endpoint}/transactions`, { searchParams: { address } })
+      .json();
+    const validatedResponse = TransactionsResponse(response);
+    if (validatedResponse instanceof type.errors) return parseError(response);
+    return Ok(validatedResponse);
+  }
+
   async login(email: string, publicKey: string) {
     const endpoint = AuthEndpoints[this.network];
     const response = await this.http.post(`${endpoint}/login`, {

commands/transactions.ts

@@ -0,0 +1,37 @@
+import { Ok } from "ts-handling";
+import { api } from "../api.js";
+import program, { logExit, printOk } from "../cli.js";
+import { getAddressFromTokenOrKey } from "./address.js";
+
+const getTransactions = async (address?: string) => {
+  const resolvedAddress = address
+    ? Ok(address)
+    : await getAddressFromTokenOrKey();
+  if (!resolvedAddress.ok) return resolvedAddress;
+
+  const response = await api.getTransactions(resolvedAddress.data);
+  if (!response.ok) return response;
+  return Ok(response.data.contents.transactions);
+};
+
+program
+  .command("transactions")
+  .description("Shows transactions for an account")
+  .option("-j, --json", "Output results as JSON")
+  .option("-t, --toon", "Output results as TOON")
+  .argument("[address]", "The account address to get transactions for")
+  .action(async (address: string | undefined) => {
+    const transactions = await getTransactions(address);
+    if (!transactions.ok) return logExit(transactions.error);
+
+    const humanReadable =
+      transactions.data.length === 0
+        ? "No transactions"
+        : transactions.data
+            .map((tx) => `${tx.type} ${tx.amount} (${tx.txId})`)
+            .join("\n");
+
+    printOk({ transactions: transactions.data }, humanReadable);
+  });
+
+export { getTransactions };

entrypoint.ts

@@ -8,6 +8,7 @@ import "./commands/import-key.js";
 import "./commands/login.js";
 import "./commands/send.js";
 import "./commands/token.js";
+import "./commands/transactions.js";
 import "./commands/withdraw.js";
 
 try {

package.json

@@ -19,9 +19,7 @@
   "bin": {
     "nova": "bin/nova.mjs"
   },
-  "files": [
-    "dist"
-  ],
+  "files": ["dist"],
   "scripts": {
     "prebuild": "pnpm del -rf dist",
     "build": "pnpm tsc",

responses/index.ts

@@ -4,4 +4,5 @@ export * from "./generate.js";
 export * from "./link-created.js";
 export * from "./rate-limited.js";
 export * from "./token-created.js";
+export * from "./transactions.js";
 export * from "./validation-error.js";

responses/transactions.ts

@@ -0,0 +1,17 @@
+import { type } from "arktype";
+
+const TransactionsResponse = type({
+  code: "200",
+  contents: {
+    transactions: type({
+      amount: "string",
+      time: "number",
+      txId: "string",
+      type: "'deposit' | 'transfer' | 'withdrawal'",
+      "from?": "string",
+      "to?": "string",
+    }).array(),
+  },
+});
+
+export { TransactionsResponse };

tests/transactions.test.ts

@@ -0,0 +1,34 @@
+import { describe, expect } from "vitest";
+import { it } from "./base.js";
+
+describe("nova transactions", () => {
+  it("prints no transactions for a fresh account", async ({ nova }) => {
+    const stdout = await nova(["transactions"]);
+    expect(stdout).toBe("No transactions");
+  });
+
+  it("prints no transactions for a fresh account in JSON format", async ({
+    nova,
+  }) => {
+    const stdout = await nova(["-j", "transactions"]);
+    const result = JSON.parse(stdout);
+    expect(result.status).toBe("ok");
+    expect(result.result.transactions).toEqual([]);
+  });
+
+  it("prints no transactions for a given address", async ({ nova }) => {
+    const address = await nova(["address"]);
+    const stdout = await nova(["transactions", address]);
+    expect(stdout).toBe("No transactions");
+  });
+
+  it("prints no transactions for a given address in JSON format", async ({
+    nova,
+  }) => {
+    const address = await nova(["address"]);
+    const stdout = await nova(["-j", "transactions", address]);
+    const result = JSON.parse(stdout);
+    expect(result.status).toBe("ok");
+    expect(result.result.transactions).toEqual([]);
+  });
+});