@trust-ethos/cli 0.0.5

package/dist/commands/user/summary.js

@@ -0,0 +1,134 @@
+import { Args, Command, Flags } from '@oclif/core';
+import pc from 'picocolors';
+import { EchoClient } from '../../lib/api/echo-client.js';
+import { formatError } from '../../lib/formatting/error.js';
+import { output } from '../../lib/formatting/output.js';
+function getScoreLevel(score) {
+    if (score < 800)
+        return 'untrusted';
+    if (score < 1200)
+        return 'questionable';
+    if (score < 1600)
+        return 'neutral';
+    if (score < 2000)
+        return 'reputable';
+    return 'exemplary';
+}
+const LEVEL_COLORS = {
+    untrusted: pc.red,
+    questionable: pc.yellow,
+    neutral: pc.white,
+    reputable: pc.green,
+    exemplary: pc.cyan,
+};
+export default class UserSummary extends Command {
+    static aliases = ['us'];
+    static args = {
+        identifier: Args.string({
+            description: 'Twitter username, ETH address, or ENS name',
+            required: true,
+        }),
+    };
+    static description = 'Display comprehensive user summary with activity and vouches';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> sethgho',
+        '<%= config.bin %> <%= command.id %> 0xNowater',
+        '<%= config.bin %> <%= command.id %> vitalik.eth --json',
+    ];
+    static flags = {
+        json: Flags.boolean({
+            char: 'j',
+            description: 'Output as JSON',
+            default: false,
+        }),
+        verbose: Flags.boolean({
+            char: 'v',
+            description: 'Show detailed error information',
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(UserSummary);
+        const client = new EchoClient();
+        try {
+            const user = await client.resolveUser(args.identifier);
+            const userkey = client.getPrimaryUserkey(user);
+            const [activities, vouches] = await Promise.all([
+                userkey ? client.getActivities(userkey, ['review', 'vouch'], 5) : [],
+                user.profileId ? client.getVouches({ subjectProfileIds: [user.profileId], archived: false, limit: 5 }) : { values: [], total: 0 },
+            ]);
+            if (flags.json) {
+                this.log(output({
+                    user,
+                    recentActivity: activities,
+                    topVouches: vouches.values,
+                }));
+                return;
+            }
+            const displayName = user.displayName || user.username || 'Unknown';
+            const level = getScoreLevel(user.score);
+            const levelColor = LEVEL_COLORS[level];
+            const lines = [
+                pc.bold(pc.cyan(`User Summary: ${displayName}`)),
+                '',
+            ];
+            if (user.username) {
+                lines.push(`${pc.dim('Username:')} @${user.username}`);
+            }
+            lines.push(`${pc.dim('Score:')} ${pc.green(String(user.score))} ${levelColor(`(${level.toUpperCase()})`)}`);
+            lines.push(`${pc.dim('XP:')} ${pc.green(user.xpTotal.toLocaleString())}`);
+            if (user.stats) {
+                const reviews = user.stats.review.received;
+                const reviewTotal = reviews.positive + reviews.neutral + reviews.negative;
+                if (reviewTotal > 0) {
+                    lines.push(`${pc.dim('Reviews:')} ${pc.green(`+${reviews.positive}`)} / ${reviews.neutral} / ${pc.red(`-${reviews.negative}`)}`);
+                }
+                const vouches = user.stats.vouch;
+                lines.push(`${pc.dim('Vouches:')} ${vouches.received.count} received, ${vouches.given.count} given`);
+            }
+            if (activities.length > 0) {
+                lines.push('');
+                lines.push(pc.bold('Recent Activity'));
+                for (const activity of activities.slice(0, 5)) {
+                    const typeIcon = activity.type === 'vouch' ? '🤝' : activity.type === 'review' ? '📝' : '❌';
+                    const authorName = activity.author.username ? `@${activity.author.username}` : activity.author.name;
+                    const subjectName = activity.subject.username ? `@${activity.subject.username}` : activity.subject.name;
+                    const date = new Date(activity.timestamp * 1000).toLocaleDateString('en-US', { month: 'short', day: 'numeric' });
+                    lines.push(`  ${typeIcon} ${authorName} → ${subjectName} ${pc.dim(`(${date})`)}`);
+                }
+            }
+            if (vouches.values.length > 0) {
+                lines.push('');
+                lines.push(pc.bold('Top Vouchers'));
+                for (const v of vouches.values.slice(0, 5)) {
+                    const authorName = v.authorUser?.username ? `@${v.authorUser.username}` : v.authorUser?.displayName || `#${v.authorProfileId}`;
+                    const amount = formatVouchAmount(v.balance);
+                    const mutualTag = v.mutualId ? pc.cyan(' [MUTUAL]') : '';
+                    lines.push(`  🤝 ${authorName} - ${pc.green(amount)}${mutualTag}`);
+                }
+            }
+            if (user.links?.profile) {
+                lines.push('');
+                lines.push(`${pc.dim('Profile:')} ${user.links.profile}`);
+            }
+            this.log(lines.join('\n'));
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.log(formatError(error, flags.verbose));
+                this.exit(1);
+            }
+        }
+    }
+}
+function formatVouchAmount(wei) {
+    const cleanWei = wei.replace(/n$/, '');
+    const eth = Number(BigInt(cleanWei)) / 1e18;
+    if (eth >= 1)
+        return eth.toFixed(4) + ' ETH';
+    if (eth >= 0.001)
+        return eth.toFixed(6) + ' ETH';
+    if (eth > 0)
+        return eth.toExponential(2) + ' ETH';
+    return '0 ETH';
+}

package/dist/commands/validator/info.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+export default class ValidatorInfo extends Command {
+    static description: string;
+    static args: {
+        tokenId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/validator/info.js

@@ -0,0 +1,53 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { EchoClient } from '../../lib/api/echo-client.js';
+import { formatError } from '../../lib/formatting/error.js';
+import { formatValidator, output } from '../../lib/formatting/output.js';
+export default class ValidatorInfo extends Command {
+    static description = 'Get details of a specific validator NFT';
+    static args = {
+        tokenId: Args.string({
+            description: 'Validator token ID',
+            required: true,
+        }),
+    };
+    static examples = [
+        '<%= config.bin %> <%= command.id %> 1',
+        '<%= config.bin %> <%= command.id %> 42 --json',
+    ];
+    static flags = {
+        json: Flags.boolean({
+            char: 'j',
+            description: 'Output as JSON',
+            default: false,
+        }),
+        verbose: Flags.boolean({
+            char: 'v',
+            description: 'Show detailed error information',
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ValidatorInfo);
+        const client = new EchoClient();
+        try {
+            const validator = await client.getValidatorByTokenId(args.tokenId);
+            if (!validator) {
+                this.log(`Validator with token ID ${args.tokenId} not found.`);
+                this.exit(1);
+                return;
+            }
+            if (flags.json) {
+                this.log(output(validator));
+            }
+            else {
+                this.log(formatValidator(validator));
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.log(formatError(error, flags.verbose));
+                this.exit(1);
+            }
+        }
+    }
+}

package/dist/commands/validator/list.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+export default class ValidatorList extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        offset: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        available: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/validator/list.js

@@ -0,0 +1,64 @@
+import { Command, Flags } from '@oclif/core';
+import { EchoClient } from '../../lib/api/echo-client.js';
+import { formatError } from '../../lib/formatting/error.js';
+import { formatValidators, output } from '../../lib/formatting/output.js';
+export default class ValidatorList extends Command {
+    static description = 'List all Ethos validator NFT owners';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --limit 20',
+        '<%= config.bin %> <%= command.id %> --available',
+        '<%= config.bin %> <%= command.id %> --json',
+    ];
+    static flags = {
+        json: Flags.boolean({
+            char: 'j',
+            description: 'Output as JSON',
+            default: false,
+        }),
+        verbose: Flags.boolean({
+            char: 'v',
+            description: 'Show detailed error information',
+            default: false,
+        }),
+        limit: Flags.integer({
+            char: 'l',
+            description: 'Max results to display',
+            default: 10,
+        }),
+        offset: Flags.integer({
+            char: 'o',
+            description: 'Number of results to skip',
+            default: 0,
+        }),
+        available: Flags.boolean({
+            char: 'a',
+            description: 'Show only validators with remaining XP capacity',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(ValidatorList);
+        const client = new EchoClient();
+        try {
+            let validators = await client.getValidators();
+            if (flags.available) {
+                validators = validators.filter(v => !v.isFull);
+            }
+            const total = validators.length;
+            validators = validators.slice(flags.offset, flags.offset + flags.limit);
+            if (flags.json) {
+                this.log(output({ values: validators, total, limit: flags.limit, offset: flags.offset }));
+            }
+            else {
+                this.log(formatValidators(validators, total));
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.log(formatError(error, flags.verbose));
+                this.exit(1);
+            }
+        }
+    }
+}

package/dist/commands/validator/sales.d.ts

@@ -0,0 +1,12 @@
+import { Command } from '@oclif/core';
+export default class ValidatorSales extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        offset: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/validator/sales.js

@@ -0,0 +1,52 @@
+import { Command, Flags } from '@oclif/core';
+import { EchoClient } from '../../lib/api/echo-client.js';
+import { formatError } from '../../lib/formatting/error.js';
+import { formatValidatorListings, output } from '../../lib/formatting/output.js';
+export default class ValidatorSales extends Command {
+    static description = 'List validator NFTs for sale on OpenSea';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --limit 20 --json',
+    ];
+    static flags = {
+        json: Flags.boolean({
+            char: 'j',
+            description: 'Output as JSON',
+            default: false,
+        }),
+        verbose: Flags.boolean({
+            char: 'v',
+            description: 'Show detailed error information',
+            default: false,
+        }),
+        limit: Flags.integer({
+            char: 'l',
+            description: 'Max results per request',
+            default: 10,
+        }),
+        offset: Flags.integer({
+            char: 'o',
+            description: 'Number of results to skip',
+            default: 0,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(ValidatorSales);
+        const client = new EchoClient();
+        try {
+            const response = await client.getValidatorListings({ limit: flags.limit, offset: flags.offset });
+            if (flags.json) {
+                this.log(output(response));
+            }
+            else {
+                this.log(formatValidatorListings(response.values, response.total));
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.log(formatError(error, flags.verbose));
+                this.exit(1);
+            }
+        }
+    }
+}

package/dist/commands/vouch/info.d.ts

@@ -0,0 +1,17 @@
+import { Command } from '@oclif/core';
+export default class VouchInfo extends Command {
+    static aliases: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<number, {
+            max?: number;
+            min?: number;
+        }>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/vouch/info.js

@@ -0,0 +1,53 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { EchoClient } from '../../lib/api/echo-client.js';
+import { formatError } from '../../lib/formatting/error.js';
+import { formatVouch, output } from '../../lib/formatting/output.js';
+export default class VouchInfo extends Command {
+    static aliases = ['vi'];
+    static args = {
+        id: Args.integer({
+            description: 'Vouch ID',
+            required: true,
+        }),
+    };
+    static description = 'Get details of a specific vouch';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> 123',
+        '<%= config.bin %> <%= command.id %> 123 --json',
+    ];
+    static flags = {
+        json: Flags.boolean({
+            char: 'j',
+            description: 'Output as JSON',
+            default: false,
+        }),
+        verbose: Flags.boolean({
+            char: 'v',
+            description: 'Show detailed error information',
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(VouchInfo);
+        const client = new EchoClient();
+        try {
+            const response = await client.getVouches({ ids: [args.id], limit: 1 });
+            if (!response.values.length) {
+                this.error(`Vouch #${args.id} not found`, { exit: 1 });
+            }
+            const vouch = response.values[0];
+            if (flags.json) {
+                this.log(output(vouch));
+            }
+            else {
+                this.log(formatVouch(vouch));
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.log(formatError(error, flags.verbose));
+                this.exit(1);
+            }
+        }
+    }
+}

package/dist/commands/vouch/list.d.ts

@@ -0,0 +1,18 @@
+import { Command } from '@oclif/core';
+export default class VouchList extends Command {
+    static aliases: string[];
+    static args: {
+        identifier: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        author: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        active: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        offset: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/vouch/list.js

@@ -0,0 +1,89 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { EchoClient } from '../../lib/api/echo-client.js';
+import { formatError } from '../../lib/formatting/error.js';
+import { formatVouches, output } from '../../lib/formatting/output.js';
+export default class VouchList extends Command {
+    static aliases = ['vl'];
+    static args = {
+        identifier: Args.string({
+            description: 'Twitter username, ETH address, or ENS name (optional, filter by subject)',
+            required: false,
+        }),
+    };
+    static description = 'List vouches for a user or all vouches';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> 0xNowater',
+        '<%= config.bin %> <%= command.id %> --author 0xNowater',
+        '<%= config.bin %> <%= command.id %> --active',
+        '<%= config.bin %> <%= command.id %> --limit 20 --json',
+    ];
+    static flags = {
+        json: Flags.boolean({
+            char: 'j',
+            description: 'Output as JSON',
+            default: false,
+        }),
+        verbose: Flags.boolean({
+            char: 'v',
+            description: 'Show detailed error information',
+            default: false,
+        }),
+        author: Flags.string({
+            description: 'Filter by author (Twitter username, ETH address, or ENS name)',
+        }),
+        active: Flags.boolean({
+            description: 'Show only active (non-archived) vouches',
+            default: false,
+        }),
+        limit: Flags.integer({
+            char: 'l',
+            description: 'Max results per request',
+            default: 10,
+        }),
+        offset: Flags.integer({
+            char: 'o',
+            description: 'Number of results to skip',
+            default: 0,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(VouchList);
+        const client = new EchoClient();
+        try {
+            const params = {
+                limit: flags.limit,
+                offset: flags.offset,
+            };
+            if (flags.active) {
+                params.archived = false;
+            }
+            if (args.identifier) {
+                const user = await client.resolveUser(args.identifier);
+                const userkey = client.getPrimaryUserkey(user);
+                if (userkey) {
+                    params.subjectUserkeys = [userkey];
+                }
+            }
+            if (flags.author) {
+                const authorUser = await client.resolveUser(flags.author);
+                if (authorUser.profileId) {
+                    params.authorProfileIds = [authorUser.profileId];
+                }
+            }
+            const response = await client.getVouches(params);
+            if (flags.json) {
+                this.log(output(response));
+            }
+            else {
+                this.log(formatVouches(response.values, response.total));
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.log(formatError(error, flags.verbose));
+                this.exit(1);
+            }
+        }
+    }
+}

package/dist/commands/vouch/mutual.d.ts

@@ -0,0 +1,15 @@
+import { Command } from '@oclif/core';
+export default class VouchMutual extends Command {
+    static args: {
+        viewer: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        target: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/vouch/mutual.js

@@ -0,0 +1,68 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { EchoClient } from '../../lib/api/echo-client.js';
+import { formatError } from '../../lib/formatting/error.js';
+import { formatMutualVouchers, output } from '../../lib/formatting/output.js';
+export default class VouchMutual extends Command {
+    static args = {
+        viewer: Args.string({
+            description: 'Viewer user (Twitter username, ETH address, or ENS name)',
+            required: true,
+        }),
+        target: Args.string({
+            description: 'Target user (Twitter username, ETH address, or ENS name)',
+            required: true,
+        }),
+    };
+    static description = 'Find mutual vouchers between two users';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> 0xNowater VitalikButerin',
+        '<%= config.bin %> <%= command.id %> 0xNowater VitalikButerin --limit 20',
+        '<%= config.bin %> <%= command.id %> 0xNowater VitalikButerin --json',
+    ];
+    static flags = {
+        json: Flags.boolean({
+            char: 'j',
+            description: 'Output as JSON',
+            default: false,
+        }),
+        verbose: Flags.boolean({
+            char: 'v',
+            description: 'Show detailed error information',
+            default: false,
+        }),
+        limit: Flags.integer({
+            char: 'l',
+            description: 'Max results',
+            default: 10,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(VouchMutual);
+        const client = new EchoClient();
+        try {
+            const [viewerUser, targetUser] = await Promise.all([
+                client.resolveUser(args.viewer),
+                client.resolveUser(args.target),
+            ]);
+            if (!viewerUser.profileId) {
+                this.error(`User ${args.viewer} does not have an Ethos profile`, { exit: 1 });
+            }
+            if (!targetUser.profileId) {
+                this.error(`User ${args.target} does not have an Ethos profile`, { exit: 1 });
+            }
+            const response = await client.getMutualVouchers(viewerUser.profileId, targetUser.profileId, { limit: flags.limit });
+            if (flags.json) {
+                this.log(output(response));
+            }
+            else {
+                this.log(formatMutualVouchers(response.values, response.total));
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.log(formatError(error, flags.verbose));
+                this.exit(1);
+            }
+        }
+    }
+}

package/dist/commands/vouch/votes.d.ts

@@ -0,0 +1,21 @@
+import { Command } from '@oclif/core';
+export default class VouchVotes extends Command {
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<number, {
+            max?: number;
+            min?: number;
+        }>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        stats: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        upvotes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        downvotes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        offset: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}