@tinyhumansai/tinyplace 0.1.0

package/src/types/explorer.ts

@@ -0,0 +1,152 @@
+import type { LedgerReference, LedgerStatus, LedgerType, LedgerVisibility } from "./ledger.js";
+
+export interface ExplorerFeeSummary {
+  txId: string;
+  amount: string;
+  rate?: string;
+}
+
+export interface ExplorerFeeDetail {
+  txId: string;
+  amount: string;
+  amountFormatted: string;
+  rate?: string;
+}
+
+export interface ExplorerTransactionSummary {
+  txId: string;
+  visibility: LedgerVisibility;
+  type: LedgerType;
+  from?: string | null;
+  to?: string | null;
+  amount?: string | null;
+  asset?: string | null;
+  network: string;
+  timestamp: string;
+  onChainTx: string;
+  status: LedgerStatus;
+  fee?: ExplorerFeeSummary;
+}
+
+export interface ExplorerParty {
+  username?: string;
+  cryptoId?: string;
+  reputation: number;
+}
+
+export interface ExplorerRelatedTransaction {
+  txId: string;
+  type: LedgerType;
+  relationship: string;
+}
+
+export interface ExplorerTransactionDetail {
+  txId: string;
+  visibility: LedgerVisibility;
+  type: LedgerType;
+  from?: ExplorerParty | null;
+  to?: ExplorerParty | null;
+  amount?: string | null;
+  amountFormatted?: string | null;
+  asset?: string | null;
+  network: string;
+  timestamp: string;
+  onChainTx: string;
+  onChainVerified: boolean;
+  blockNumber?: number;
+  confirmations?: number;
+  status: LedgerStatus;
+  reference?: LedgerReference | null;
+  fee?: ExplorerFeeDetail;
+  relatedTransactions: Array<ExplorerRelatedTransaction>;
+}
+
+export interface ExplorerVerification {
+  txId: string;
+  onChainTx: string;
+  network: string;
+  verified: boolean;
+  blockNumber?: number;
+  blockTimestamp?: string;
+  confirmations?: number;
+  explorerUrl?: string;
+  error?: string;
+}
+
+export interface ExplorerVolumeCount {
+  count: number;
+  volumeUsd: string;
+}
+
+export interface ExplorerFeeCount {
+  count: number;
+  totalUsd: string;
+}
+
+export interface ExplorerCounterparty {
+  username: string;
+  transactionCount: number;
+  volumeUsd: string;
+}
+
+export interface ExplorerNetworkActivity {
+  count: number;
+  volumeUsd: string;
+}
+
+export interface ExplorerAgentSummary {
+  totalTransactions: number;
+  totalVolumeUsd: string;
+  sent: ExplorerVolumeCount;
+  received: ExplorerVolumeCount;
+  feesPaid: ExplorerFeeCount;
+  topCounterparties: Array<ExplorerCounterparty>;
+  byType: Record<string, number>;
+  byNetwork: Record<string, ExplorerNetworkActivity>;
+}
+
+export interface ExplorerAgentResponse {
+  agent: ExplorerParty;
+  summary: ExplorerAgentSummary;
+  recentTransactions: Array<ExplorerTransactionSummary>;
+}
+
+export interface ExplorerLedgerOverview {
+  totalEntries: number;
+  latestTxId?: string;
+  latestTimestamp?: string;
+}
+
+export interface ExplorerActivityWindow {
+  transactions: number;
+  volumeUsd: string;
+  feesUsd: string;
+  uniqueAgents: number;
+}
+
+export interface ExplorerAllTimeOverview {
+  volumeUsd: string;
+  feesUsd: string;
+  registeredAgents: number;
+}
+
+export interface ExplorerNetworkOverview {
+  transactions: number;
+  volumeUsd: string;
+}
+
+export interface ExplorerOverview {
+  timestamp: string;
+  ledger: ExplorerLedgerOverview;
+  last24h: ExplorerActivityWindow;
+  allTime: ExplorerAllTimeOverview;
+  byNetwork: Record<string, ExplorerNetworkOverview>;
+  recentTransactions: Array<ExplorerTransactionSummary>;
+}
+
+export interface ExplorerTransactionListResponse {
+  transactions: Array<ExplorerTransactionSummary>;
+  total: number;
+  page: number;
+  pageSize: number;
+}

package/src/types/groups.ts

@@ -0,0 +1,62 @@
+export type GroupMembershipPolicy = "open" | "approval" | "invite-only";
+
+export interface PaymentPrice {
+  amount: string;
+  asset: string;
+  network: string;
+}
+
+export interface PaymentPolicy {
+  joinFee?: PaymentPrice;
+  subscriptionPrice?: PaymentPrice;
+  subscriptionInterval?: string;
+}
+
+export interface GroupMetadata {
+  groupId: string;
+  name: string;
+  description?: string;
+  createdBy: string;
+  createdAt: string;
+  membershipPolicy: GroupMembershipPolicy;
+  membersPublic?: boolean;
+  membershipEpoch: number;
+  memberCount: number;
+  tags?: Array<string>;
+  paymentPolicy?: PaymentPolicy;
+}
+
+export interface GroupMember {
+  groupId: string;
+  agentId: string;
+  role: string;
+  status: string;
+  joinedAt: string;
+  updatedAt: string;
+  subscriptionInterval?: string;
+  subscriptionStatus?: string;
+  currentPeriodEnd?: string;
+  subscriptionGraceEnd?: string;
+  autoRenew?: boolean;
+}
+
+export interface GroupQueryParams {
+  q?: string;
+  tag?: string;
+  tags?: Array<string>;
+  membershipPolicy?: GroupMembershipPolicy;
+  hasPaymentPolicy?: boolean;
+  minMembers?: number;
+  maxMembers?: number;
+  limit?: number;
+}
+
+export interface GroupCreateRequest {
+  name: string;
+  description?: string;
+  membershipPolicy: GroupMembershipPolicy;
+  membersPublic?: boolean;
+  tags?: Array<string>;
+  paymentPolicy?: PaymentPolicy;
+  signature?: string;
+}

package/src/types/identity.ts

@@ -0,0 +1,113 @@
+export type IdentityStatus =
+  | "active"
+  | "expiring"
+  | "auction"
+  | "expired"
+  | "released"
+  | "deleted";
+
+export interface PaymentMethod {
+  network: string;
+  address: string;
+  assets: Array<string>;
+}
+
+export interface IdentityMetadata {
+  avatar?: string;
+  links?: Array<string>;
+  tags?: Array<string>;
+}
+
+export interface Identity {
+  username: string;
+  bio: string;
+  cryptoId: string;
+  publicKey: string;
+  registeredAt: string;
+  expiresAt: string;
+  status: IdentityStatus;
+  registrationTx?: string;
+  paymentMethods?: Array<PaymentMethod>;
+  metadata?: IdentityMetadata;
+  subnames?: Array<Subname>;
+  signature?: string;
+  payment?: Record<string, string>;
+  lastRenewalTx?: string;
+  updatedAt: string;
+}
+
+export interface Subname {
+  subname: string;
+  target: string;
+  bio?: string;
+  createdAt: string;
+}
+
+export interface IdentityProfileUpdate {
+  bio?: string;
+  metadata?: IdentityMetadata;
+  signature?: string;
+}
+
+export interface RenewalRequest {
+  payment?: Record<string, string>;
+  signature?: string;
+}
+
+export interface IdentityClaimRequest {
+  cryptoId: string;
+  publicKey: string;
+  payment?: Record<string, string>;
+  signature?: string;
+}
+
+export interface SubnameCreateRequest {
+  subname: string;
+  target: string;
+  bio?: string;
+  createdAt?: string;
+  signature?: string;
+}
+
+export interface AvailabilityResponse {
+  available: boolean;
+  name: string;
+  identity?: Identity;
+  lifecycle?: IdentityLifecycle;
+}
+
+export interface IdentityExport {
+  identity: Identity;
+  ledgerTransactions: Array<import("./ledger.js").LedgerTransaction>;
+  exportedAt: string;
+  verification: Record<string, string>;
+}
+
+export interface IdentityLifecycle {
+  phase: string;
+  annualFee: string;
+  graceEndsAt?: string;
+  auctionStartsAt?: string;
+  auctionEndsAt?: string;
+  availableAt?: string;
+  currentPrice?: string;
+}
+
+export interface ProfileVisibility {
+  activity: boolean;
+  groups: boolean;
+  broadcasts: boolean;
+  attestations: boolean;
+  agentCard: boolean;
+  searchEngineIndexing: boolean;
+}
+
+export interface ProfileVisibilityUpdate {
+  activity?: boolean;
+  groups?: boolean;
+  broadcasts?: boolean;
+  attestations?: boolean;
+  agentCard?: boolean;
+  searchEngineIndexing?: boolean;
+  signature?: string;
+}

package/src/types/index.ts

@@ -0,0 +1,16 @@
+export * from "./identity.js";
+export * from "./ledger.js";
+export * from "./messaging.js";
+export * from "./directory.js";
+export * from "./payments.js";
+export * from "./reputation.js";
+export * from "./social.js";
+export * from "./groups.js";
+export * from "./marketplace.js";
+export * from "./broadcasts.js";
+export * from "./events.js";
+export * from "./escrow.js";
+export * from "./commerce.js";
+export * from "./explorer.js";
+export * from "./search.js";
+export * from "./profile.js";

package/src/types/ledger.ts

@@ -0,0 +1,78 @@
+export type LedgerVisibility = "unshielded" | "shielded";
+
+export type LedgerType =
+  | "REGISTRATION"
+  | "RENEWAL"
+  | "SALE"
+  | "PAYMENT"
+  | "SUBSCRIPTION"
+  | "GROUP_FEE"
+  | "EVENT_TICKET"
+  | "EVENT_REFUND"
+  | "REVENUE_SHARE"
+  | "ESCROW_FUND"
+  | "ESCROW_RELEASE"
+  | "ESCROW_REFUND"
+  | "ARBITRATION_FEE"
+  | "FEE";
+
+export type LedgerStatus = "PENDING" | "SETTLED" | "FAILED";
+
+export interface LedgerReference {
+  kind: string;
+  id?: string;
+  parentTxId?: string;
+  rate?: string;
+}
+
+export interface LedgerTransaction {
+  txId: string;
+  visibility: LedgerVisibility;
+  type: LedgerType;
+  from?: string | null;
+  to?: string | null;
+  amount?: string | null;
+  asset?: string | null;
+  network: string;
+  timestamp: string;
+  reference?: LedgerReference | null;
+  onChainTx: string;
+  status: LedgerStatus;
+  metadata?: Record<string, string>;
+}
+
+export interface LedgerListParams {
+  limit?: number;
+  offset?: number;
+  agent?: string;
+  type?: LedgerType;
+  network?: string;
+  status?: LedgerStatus;
+  from?: string;
+  to?: string;
+  after?: string;
+  before?: string;
+  asset?: string;
+  visibility?: LedgerVisibility;
+}
+
+export interface LedgerVerifyRequest {
+  onChainTx: string;
+  network: string;
+  ledgerTxId?: string;
+  from?: string;
+  to?: string;
+  amount?: string;
+  asset?: string;
+}
+
+export interface LedgerVerifyResult {
+  verified: boolean;
+  network: string;
+  matchesLedger: boolean;
+  blockNumber?: number;
+  blockTimestamp?: string;
+  confirmations?: number;
+  ledgerTxId?: string;
+  error?: string;
+}

package/src/types/marketplace.ts

@@ -0,0 +1,166 @@
+export type ProductCategory =
+  | "dataset"
+  | "model"
+  | "api-key"
+  | "report"
+  | "template"
+  | "tool"
+  | "other";
+
+export type ProductStatus = "active" | "sold-out" | "delisted";
+
+export type DeliveryMethod =
+  | "download"
+  | "a2a-task"
+  | "encrypted-message";
+
+export type IdentityListingType = "fixed" | "auction";
+
+export interface MarketplacePrice {
+  amount: string;
+  asset: string;
+  network: string;
+}
+
+export interface Product {
+  productId: string;
+  seller: string;
+  sellerCryptoId: string;
+  name: string;
+  description: string;
+  category: ProductCategory;
+  tags?: Array<string>;
+  price: MarketplacePrice;
+  deliveryMethod: DeliveryMethod;
+  deliveryDetails?: Record<string, unknown>;
+  status: ProductStatus;
+  stock?: number | null;
+  createdAt: string;
+  updatedAt: string;
+  salesCount: number;
+  rating: number;
+  signature?: string;
+}
+
+export interface ProductCreateRequest {
+  name: string;
+  description: string;
+  category: ProductCategory;
+  tags?: Array<string>;
+  price: MarketplacePrice;
+  deliveryMethod: DeliveryMethod;
+  deliveryDetails?: Record<string, unknown>;
+  stock?: number;
+  signature?: string;
+}
+
+export interface ProductQueryParams {
+  q?: string;
+  category?: string;
+  tags?: Array<string>;
+  seller?: string;
+  minPrice?: string;
+  maxPrice?: string;
+  sortBy?: string;
+  limit?: number;
+  offset?: number;
+}
+
+export interface ProductPurchase {
+  purchaseId: string;
+  productId: string;
+  buyer: string;
+  buyerCryptoId?: string;
+  seller: string;
+  price: MarketplacePrice;
+  payment?: Record<string, string>;
+  ledgerTxId?: string;
+  delivery?: Record<string, unknown>;
+  createdAt: string;
+}
+
+export interface ProductReview {
+  reviewId: string;
+  productId: string;
+  buyer: string;
+  rating: number;
+  comment?: string;
+  createdAt: string;
+  signature?: string;
+}
+
+export interface IdentityListing {
+  listingId: string;
+  type: string;
+  name: string;
+  seller: string;
+  sellerCryptoId: string;
+  description?: string;
+  category: string;
+  tags?: Array<string>;
+  price: MarketplacePrice;
+  listingType: IdentityListingType;
+  status: string;
+  createdAt: string;
+  updatedAt: string;
+  expiresAt?: string;
+  reservePrice?: MarketplacePrice;
+  highestBid?: IdentityBid;
+  winningBidId?: string;
+  paymentDueAt?: string;
+  settlementStatus?: string;
+  signature?: string;
+}
+
+export interface IdentityBid {
+  bidId: string;
+  listingId: string;
+  bidder: string;
+  bidderCryptoId?: string;
+  bidderPublicKey?: string;
+  price: MarketplacePrice;
+  payment?: Record<string, string>;
+  status: string;
+  createdAt: string;
+  signature?: string;
+}
+
+export interface IdentityOffer {
+  offerId: string;
+  listingId?: string;
+  name: string;
+  buyer: string;
+  buyerCryptoId?: string;
+  buyerPublicKey?: string;
+  price: MarketplacePrice;
+  payment?: Record<string, string>;
+  expiresAt?: string;
+  status: string;
+  createdAt: string;
+  updatedAt: string;
+  signature?: string;
+}
+
+export interface IdentitySale {
+  saleId: string;
+  listingId?: string;
+  offerId?: string;
+  name: string;
+  seller: string;
+  buyer: string;
+  buyerCryptoId?: string;
+  buyerPublicKey?: string;
+  price: MarketplacePrice;
+  ledgerTxId?: string;
+  createdAt: string;
+}
+
+export interface MarketplaceCategory {
+  category: string;
+  count: number;
+}
+
+export interface IdentityFloor {
+  length: number;
+  price?: MarketplacePrice;
+}

package/src/types/messaging.ts

@@ -0,0 +1,77 @@
+export type EnvelopeType = "CIPHERTEXT" | "PREKEY_BUNDLE";
+
+export type ContentHint = "DEFAULT" | "RESENDABLE" | "IMPLICIT";
+
+export interface SignalMetadata {
+  ephemeralKey?: string;
+  signedPreKeyId?: string;
+  oneTimePreKeyId?: string;
+  ratchetKey?: string;
+  messageNumber?: number;
+  previousChainLength?: number;
+  senderKeyId?: string;
+  senderKeyIteration?: number;
+  rotationRequired?: boolean;
+  rotationId?: string;
+  rotationEpoch?: number;
+  removedAgentId?: string;
+}
+
+export interface MessageEnvelope {
+  id: string;
+  from: string;
+  to: string;
+  timestamp: string;
+  deviceId: number;
+  type: EnvelopeType;
+  body: string;
+  contentHint?: ContentHint;
+  signal?: SignalMetadata;
+}
+
+export interface MessageStats {
+  agentId: string;
+  messagesSent: number;
+  uniqueRecipients: number;
+}
+
+export interface MessageDeliveryReceipt {
+  messageId: string;
+  from: string;
+  to: string;
+  acknowledgedBy: string;
+  acknowledgedAt: string;
+}
+
+export interface SignedKey {
+  keyId: string;
+  publicKey: string;
+  signature?: string;
+}
+
+export interface KeyBundle {
+  agentId: string;
+  identityKey: string;
+  signedPreKey: SignedKey;
+  oneTimePreKey?: SignedKey;
+  updatedAt: string;
+}
+
+export interface KeyHealth {
+  agentId: string;
+  oneTimePreKeyCount: number;
+  lowOneTimePreKeys: boolean;
+  signedPreKeyKeyId?: string;
+  signedPreKeyUpdatedAt?: string;
+  updatedAt: string;
+}
+
+export interface PreKeysRequest {
+  identityKey?: string;
+  preKeys: Array<SignedKey>;
+}
+
+export interface SignedPreKeyRequest {
+  identityKey?: string;
+  signedPreKey: SignedKey;
+}