@helium/blockchain-api 0.1.2 → 0.1.3

package/src/server/api/routers/welcomePacks/procedures/get.ts

@@ -1,36 +0,0 @@
-import { publicProcedure } from "../../../procedures";
-import { GetInputSchema, WelcomePackSchema } from "../schemas";
-import { getWelcomePackByAddress } from "@/lib/queries/welcome-packs";
-import { welcomePackKey } from "@helium/welcome-pack-sdk";
-import { PublicKey } from "@solana/web3.js";
-
-/**
- * Get a welcome pack by wallet address and pack ID.
- */
-export const get = publicProcedure
-  .route({
-    method: "GET",
-    path: "/welcome-packs/wallet/{walletAddress}/{packId}",
-  })
-  .input(GetInputSchema)
-  .output(WelcomePackSchema)
-  .errors({
-    NOT_FOUND: { message: "Welcome pack not found" },
-  })
-  .handler(async ({ input, errors }) => {
-    const { walletAddress, packId } = input;
-
-    // Derive the welcome pack address from wallet and packId
-    const welcomePackAddress = welcomePackKey(
-      new PublicKey(walletAddress),
-      Number(packId),
-    )[0].toBase58();
-
-    const pack = await getWelcomePackByAddress(welcomePackAddress);
-
-    if (!pack) {
-      throw errors.NOT_FOUND({ message: "Welcome pack not found" });
-    }
-
-    return pack;
-  });

package/src/server/api/routers/welcomePacks/procedures/getByAddress.ts

@@ -1,26 +0,0 @@
-import { publicProcedure } from "../../../procedures";
-import { GetByAddressInputSchema, WelcomePackSchema } from "../schemas";
-import { ORPCError } from "@orpc/server";
-import { getWelcomePackByAddress } from "@/lib/queries/welcome-packs";
-
-/**
- * Get a welcome pack by its address.
- */
-export const getByAddress = publicProcedure
-  .route({ method: "GET", path: "/welcome-packs/{packAddress}" })
-  .input(GetByAddressInputSchema)
-  .output(WelcomePackSchema)
-  .errors({
-    NOT_FOUND: { message: "Welcome pack not found" },
-  })
-  .handler(async ({ input, errors }) => {
-    const { packAddress } = input;
-
-    const pack = await getWelcomePackByAddress(packAddress);
-
-    if (!pack) {
-      throw errors.NOT_FOUND({ message: "Welcome pack not found" });
-    }
-
-    return pack;
-  });

package/src/server/api/routers/welcomePacks/procedures/invite.ts

@@ -1,44 +0,0 @@
-import { publicProcedure } from "../../../procedures";
-import { InviteInputSchema, InviteOutputSchema } from "../schemas";
-import { ORPCError } from "@orpc/server";
-import { createSolanaConnection } from "@/lib/solana";
-import { init as initWelcomePack } from "@helium/welcome-pack-sdk";
-import { PublicKey } from "@solana/web3.js";
-
-/**
- * Generate an invite message to be signed for a welcome pack.
- */
-export const invite = publicProcedure
-  .route({
-    method: "POST",
-    path: "/welcome-packs/{packAddress}/invite/{walletAddress}",
-  })
-  .input(InviteInputSchema)
-  .output(InviteOutputSchema)
-  .errors({
-    BAD_REQUEST: { message: "Invalid request" },
-  })
-  .handler(async ({ input, errors }) => {
-    const { packAddress, walletAddress, expirationDays } = input;
-
-    if (!packAddress || !walletAddress) {
-      throw errors.BAD_REQUEST({
-        message: "Pack address and wallet address are required",
-      });
-    }
-
-    // Load uniqueId from on-chain welcome pack account
-    const { provider } = createSolanaConnection(walletAddress);
-    const program = await initWelcomePack(provider);
-    const welcomePack = await program.account.welcomePackV0.fetch(
-      new PublicKey(packAddress),
-    );
-    const uniqueId = welcomePack.uniqueId.toString();
-    const expirationTs =
-      Math.floor(Date.now() / 1000) + expirationDays * 24 * 60 * 60;
-
-    // Keep the canonical message format aligned with client expectations
-    const message = `Approve invite ${uniqueId} expiring ${expirationTs}`;
-
-    return { message, expirationTs };
-  });

package/src/server/api/routers/welcomePacks/procedures/list.ts

@@ -1,27 +0,0 @@
-import { publicProcedure } from "../../../procedures";
-import { ListInputSchema, ListOutputSchema } from "../schemas";
-import { ORPCError } from "@orpc/server";
-import { getWelcomePacksByOwner } from "@/lib/queries/welcome-packs";
-
-/**
- * List all welcome packs for a wallet.
- */
-export const list = publicProcedure
-  .route({ method: "GET", path: "/welcome-packs/wallet/{walletAddress}" })
-  .input(ListInputSchema)
-  .output(ListOutputSchema)
-  .errors({
-    BAD_REQUEST: { message: "Wallet address is required" },
-  })
-  .handler(async ({ input }) => {
-    const { walletAddress } = input;
-
-    if (!walletAddress) {
-      throw new ORPCError("BAD_REQUEST", {
-        message: "Wallet address is required",
-      });
-    }
-
-    const packs = await getWelcomePacksByOwner(walletAddress);
-    return packs;
-  });

package/src/server/api/routers/welcomePacks/router.ts

@@ -1,27 +0,0 @@
-import { list } from "./procedures/list";
-import { create } from "./procedures/create";
-import { get } from "./procedures/get";
-import { deletePack } from "./procedures/deletePack";
-import { getByAddress } from "./procedures/getByAddress";
-import { claim } from "./procedures/claim";
-import { invite } from "./procedures/invite";
-
-/**
- * Welcome Packs router - handles welcome pack operations.
- */
-export const welcomePacksRouter = {
-  /** List all welcome packs for a wallet */
-  list,
-  /** Create a new welcome pack */
-  create,
-  /** Get a welcome pack by wallet and pack ID */
-  get,
-  /** Delete a welcome pack */
-  delete: deletePack,
-  /** Get a welcome pack by its address */
-  getByAddress,
-  /** Claim a welcome pack */
-  claim,
-  /** Generate an invite message for a welcome pack */
-  invite,
-};

package/src/server/api/routers/welcomePacks/schemas.ts

@@ -1,135 +0,0 @@
-import { z } from "zod";
-import { HotspotSchema } from "@/server/api/schemas";
-
-// ============================================================================
-// Input Schemas
-// ============================================================================
-
-export const ListInputSchema = z.object({
-  walletAddress: z.string().min(32),
-});
-
-export const RewardSplitInputSchema = z.object({
-  address: z.string(),
-  type: z.enum(["percentage", "fixed"]),
-  amount: z.number(),
-});
-
-export const ScheduleInputSchema = z.object({
-  frequency: z.enum(["daily", "weekly", "monthly"]),
-  time: z.string(),
-  timezone: z.string(),
-  dayOfWeek: z.string().optional(),
-  dayOfMonth: z.string().optional(),
-});
-
-export const CreateInputSchema = z.object({
-  walletAddress: z.string().min(32),
-  assetId: z.string(),
-  solAmount: z.number(),
-  rentRefund: z.string(),
-  assetReturnAddress: z.string(),
-  rewardsSplit: z.array(RewardSplitInputSchema),
-  schedule: ScheduleInputSchema,
-  lazyDistributor: z.string(),
-});
-
-export const GetInputSchema = z.object({
-  walletAddress: z.string().min(32),
-  packId: z.number(),
-});
-
-export const DeleteInputSchema = z.object({
-  walletAddress: z.string().min(32),
-  packId: z.number(),
-});
-
-export const GetByAddressInputSchema = z.object({
-  packAddress: z.string().min(32),
-});
-
-export const ClaimInputSchema = z.object({
-  packAddress: z.string().min(32),
-  walletAddress: z.string().min(32),
-  signature: z.string(),
-  expirationTs: z.string(),
-});
-
-export const InviteInputSchema = z.object({
-  packAddress: z.string().min(32),
-  walletAddress: z.string().min(32),
-  expirationDays: z.number().int().positive().max(365).default(7),
-});
-
-// ============================================================================
-// Output Schemas
-// ============================================================================
-
-export const WelcomePackSchema = z.object({
-  address: z.string(),
-  id: z.number(),
-  owner: z.string(),
-  asset: z.string(),
-  lazyDistributor: z.string(),
-  rewardsMint: z.string(),
-  rentRefund: z.string(),
-  solAmount: z.string(),
-  rewardsSplit: z.array(RewardSplitInputSchema),
-  rewardsSchedule: z.string(),
-  assetReturnAddress: z.string(),
-  bumpSeed: z.number(),
-  uniqueId: z.string(),
-  loading: z.boolean().optional(),
-  hotspot: HotspotSchema.nullable(),
-});
-
-export const ListOutputSchema = z.array(WelcomePackSchema);
-
-export const TransactionMetadataSchema = z
-  .object({
-    type: z.string(),
-    description: z.string(),
-  })
-  .catchall(z.unknown());
-
-export const TransactionItemSchema = z.object({
-  serializedTransaction: z.string(),
-  metadata: TransactionMetadataSchema.optional(),
-});
-
-export const TransactionDataSchema = z.object({
-  transactions: z.array(TransactionItemSchema),
-  parallel: z.boolean(),
-  tag: z.string().optional(),
-});
-
-export const CreateOutputSchema = z.object({
-  welcomePack: WelcomePackSchema,
-  transactionData: TransactionDataSchema,
-});
-
-export const DeleteOutputSchema = z.object({
-  transactionData: TransactionDataSchema,
-});
-
-export const ClaimOutputSchema = z.object({
-  transactionData: TransactionDataSchema,
-});
-
-export const InviteOutputSchema = z.object({
-  message: z.string(),
-  expirationTs: z.number(),
-});
-
-// ============================================================================
-// Type Exports
-// ============================================================================
-
-export type ListInput = z.infer<typeof ListInputSchema>;
-export type CreateInput = z.infer<typeof CreateInputSchema>;
-export type GetInput = z.infer<typeof GetInputSchema>;
-export type DeleteInput = z.infer<typeof DeleteInputSchema>;
-export type GetByAddressInput = z.infer<typeof GetByAddressInputSchema>;
-export type ClaimInput = z.infer<typeof ClaimInputSchema>;
-export type InviteInput = z.infer<typeof InviteInputSchema>;
-export type WelcomePack = z.infer<typeof WelcomePackSchema>;

package/src/server/api/schemas.ts

@@ -1,281 +0,0 @@
-import { z } from "zod";
-
-// ============================================================================
-// Common Transaction Schemas
-// ============================================================================
-
-/**
- * Metadata associated with a transaction for tracking and display purposes.
- */
-export const TransactionMetadataSchema = z
-  .object({
-    type: z.string(),
-    description: z.string(),
-  })
-  .catchall(z.unknown());
-
-/**
- * A single transaction item with serialized data and optional metadata.
- */
-export const TransactionItemSchema = z.object({
-  serializedTransaction: z.string(),
-  metadata: TransactionMetadataSchema.optional(),
-});
-
-/**
- * Transaction data returned by procedures that create transactions.
- * Contains serialized transactions ready for signing and submission.
- */
-export const TransactionDataSchema = z.object({
-  transactions: z.array(TransactionItemSchema),
-  parallel: z.boolean(),
-  tag: z.string().optional(),
-});
-
-/**
- * Request schema for submitting a batch of transactions.
- */
-export const TransactionBatchRequestSchema = z.object({
-  transactions: z.array(TransactionItemSchema),
-  parallel: z.boolean(),
-  tag: z.string().optional(),
-});
-
-/**
- * Response schema for transaction batch submission.
- */
-export const TransactionBatchResponseSchema = z.object({
-  batchId: z.string(),
-  message: z.string().optional(),
-});
-
-// ============================================================================
-// Common Response Schemas
-// ============================================================================
-
-/**
- * Standard error response schema.
- */
-export const ErrorResponseSchema = z.object({
-  error: z.string(),
-  details: z.array(z.string()).optional(),
-});
-
-// ============================================================================
-// Wallet Address Schema
-// ============================================================================
-
-/**
- * Solana wallet address validation.
- */
-export const WalletAddressSchema = z.string().min(32).max(44);
-
-/**
- * Solana public key validation (base58 encoded).
- */
-export const PublicKeySchema = z.string().min(32).max(44);
-
-// ============================================================================
-// Pagination Schemas
-// ============================================================================
-
-/**
- * Standard pagination input schema.
- */
-export const PaginationInputSchema = z.object({
-  page: z.coerce.number().int().min(1).default(1),
-  limit: z.coerce.number().int().min(1).max(100).default(10),
-});
-
-/**
- * Standard pagination output schema.
- */
-export const PaginationOutputSchema = z.object({
-  total: z.number(),
-  page: z.number(),
-  totalPages: z.number(),
-});
-
-// ============================================================================
-// Hotspot Schemas
-// ============================================================================
-
-/**
- * Hotspot type enumeration.
- */
-export const HotspotTypeSchema = z.enum(["iot", "mobile", "all"]);
-
-/**
- * Hotspot device type enumeration.
- */
-export const DeviceTypeSchema = z.enum([
-  "iot-gateway",
-  "wifiIndoor",
-  "wifiOutdoor",
-  "wifiDataOnly",
-  "cbrs",
-]);
-
-/**
- * Hotspot ownership type enumeration.
- */
-export const OwnershipTypeSchema = z.enum(["owner", "direct", "fanout", "all"]);
-
-/**
- * Hotspot share configuration.
- */
-export const HotspotSharesSchema = z.object({
-  fixed: z.string().optional(),
-  percentage: z.number().optional(),
-});
-
-/**
- * Complete hotspot data schema.
- */
-export const HotspotSchema = z.object({
-  address: z.string(),
-  entityKey: z.string(),
-  name: z.string(),
-  type: HotspotTypeSchema,
-  deviceType: DeviceTypeSchema,
-  city: z.string().optional(),
-  state: z.string().optional(),
-  country: z.string().optional(),
-  asset: z.string(),
-  isOnline: z.boolean().optional(),
-  owner: z.string().optional(),
-  shares: HotspotSharesSchema.optional(),
-  ownershipType: z.string(),
-});
-
-/**
- * Paginated hotspots response schema.
- */
-export const HotspotsDataSchema = z.object({
-  hotspots: z.array(HotspotSchema),
-  total: z.number(),
-  page: z.number(),
-  totalPages: z.number(),
-});
-
-// ============================================================================
-// Token Schemas
-// ============================================================================
-
-/**
- * Token account data schema.
- */
-export const TokenAccountSchema = z.object({
-  mint: z.string(),
-  address: z.string(),
-  balance: z.string(),
-  decimals: z.number(),
-  uiAmount: z.number(),
-  symbol: z.string().optional(),
-  name: z.string().optional(),
-  logoURI: z.string().optional(),
-  priceUsd: z.number().optional(),
-  balanceUsd: z.number().optional(),
-});
-
-/**
- * Token balance data response schema.
- */
-export const TokenBalanceDataSchema = z.object({
-  totalBalanceUsd: z.number(),
-  solBalance: z.number(),
-  solBalanceUsd: z.number(),
-  tokens: z.array(TokenAccountSchema),
-});
-
-// ============================================================================
-// Welcome Pack Schemas
-// ============================================================================
-
-/**
- * Reward split recipient schema.
- */
-export const RewardSplitSchema = z.object({
-  address: z.string(),
-  type: z.enum(["percentage", "fixed"]),
-  amount: z.number(),
-});
-
-/**
- * Schedule configuration schema.
- */
-export const ScheduleSchema = z.object({
-  frequency: z.enum(["daily", "weekly", "monthly"]),
-  time: z.string(),
-  timezone: z.string(),
-  dayOfWeek: z.string().optional(),
-  dayOfMonth: z.string().optional(),
-});
-
-/**
- * Welcome pack with status schema.
- */
-export const WelcomePackWithStatusSchema = z.object({
-  address: z.string(),
-  id: z.number(),
-  owner: z.string(),
-  asset: z.string(),
-  lazyDistributor: z.string(),
-  rewardsMint: z.string(),
-  rentRefund: z.string(),
-  solAmount: z.string(),
-  rewardsSplit: z.array(RewardSplitSchema),
-  rewardsSchedule: z.string(),
-  assetReturnAddress: z.string(),
-  bumpSeed: z.number(),
-  uniqueId: z.string(),
-  loading: z.boolean().optional(),
-});
-
-// ============================================================================
-// Split Schemas
-// ============================================================================
-
-/**
- * Split share schema.
- */
-export const SplitShareSchema = z.object({
-  wallet: z.string(),
-  delegate: z.string(),
-  fixed: z.number(),
-  shares: z.number(),
-});
-
-/**
- * Split response schema.
- */
-export const SplitResponseSchema = z.object({
-  walletAddress: z.string(),
-  hotspotPubkey: z.string(),
-  splitAddress: z.string(),
-  shares: z.array(SplitShareSchema),
-});
-
-// ============================================================================
-// Type Exports
-// ============================================================================
-
-export type TransactionMetadata = z.infer<typeof TransactionMetadataSchema>;
-export type TransactionItem = z.infer<typeof TransactionItemSchema>;
-export type TransactionData = z.infer<typeof TransactionDataSchema>;
-export type TransactionBatchRequest = z.infer<
-  typeof TransactionBatchRequestSchema
->;
-export type TransactionBatchResponse = z.infer<
-  typeof TransactionBatchResponseSchema
->;
-export type ErrorResponse = z.infer<typeof ErrorResponseSchema>;
-export type Hotspot = z.infer<typeof HotspotSchema>;
-export type HotspotsData = z.infer<typeof HotspotsDataSchema>;
-export type TokenAccount = z.infer<typeof TokenAccountSchema>;
-export type TokenBalanceData = z.infer<typeof TokenBalanceDataSchema>;
-export type RewardSplit = z.infer<typeof RewardSplitSchema>;
-export type Schedule = z.infer<typeof ScheduleSchema>;
-export type WelcomePackWithStatus = z.infer<typeof WelcomePackWithStatusSchema>;
-export type SplitShare = z.infer<typeof SplitShareSchema>;
-export type SplitResponse = z.infer<typeof SplitResponseSchema>;