@helium/blockchain-api 0.2.1 → 0.2.3

package/dist/index.js

@@ -92,6 +92,7 @@ var ErrorResponseSchema = z.object({
 });
 var WalletAddressSchema = z.string().min(32).max(44);
 var PublicKeySchema = z.string().min(32).max(44);
+var HeliumPublicKeySchema = z.string().min(32).max(400);
 var PaginationInputSchema = z.object({
   page: z.coerce.number().int().min(1).default(1),
   limit: z.coerce.number().int().min(1).max(100).default(10)
@@ -106,17 +107,17 @@ var HealthResponseSchema = z.object({
   error: z.string().optional()
 });
 var GetBalancesInputSchema = z.object({
-  walletAddress: z.string().min(32)
+  walletAddress: WalletAddressSchema
 });
 var TransferInputSchema = z.object({
-  walletAddress: z.string().min(32),
+  walletAddress: WalletAddressSchema,
   mint: z.string().nullable().optional(),
   destination: z.string().min(32),
   amount: z.string(),
   decimals: z.number().optional()
 });
 var CreateHntAccountInputSchema = z.object({
-  walletAddress: z.string().min(32)
+  walletAddress: WalletAddressSchema
 });
 var TokenAccountSchema = z.object({
   mint: z.string(),
@@ -143,33 +144,6 @@ var CreateHntAccountOutputSchema = z.object({
   transactionData: TransactionDataSchema
 });
 var HotspotTypeSchema = z.enum(["iot", "mobile", "all"]);
-var DeviceTypeSchema = z.enum([
-  "iot-gateway",
-  "wifiIndoor",
-  "wifiOutdoor",
-  "wifiDataOnly",
-  "cbrs"
-]);
-var OwnershipTypeSchema = z.enum(["owner", "direct", "fanout", "all"]);
-var HotspotSharesSchema = z.object({
-  fixed: z.string().optional(),
-  percentage: z.number().optional()
-});
-var 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()
-});
 var GetHotspotsInputSchema = z.object({
   walletAddress: z.string().min(32),
   type: HotspotTypeSchema.optional(),
@@ -220,6 +194,57 @@ var DeleteSplitInputSchema = z.object({
   walletAddress: z.string().min(32),
   hotspotPubkey: z.string().min(1)
 });
+var GetAutomationStatusInputSchema = z.object({
+  walletAddress: z.string().min(32)
+});
+var AutomationScheduleSchema = z.enum(["daily", "weekly", "monthly"]);
+var SetupAutomationInputSchema = z.object({
+  walletAddress: z.string().min(32),
+  schedule: AutomationScheduleSchema,
+  duration: z.number().int().min(1),
+  // Number of claims
+  totalHotspots: z.number().int().min(1)
+});
+var FundAutomationInputSchema = z.object({
+  walletAddress: z.string().min(32),
+  additionalDuration: z.number().int().min(1)
+  // Additional number of claims
+});
+var GetFundingEstimateInputSchema = z.object({
+  walletAddress: z.string().min(32),
+  duration: z.coerce.number().int().min(1)
+  // Number of claims to estimate funding for
+});
+var CloseAutomationInputSchema = z.object({
+  walletAddress: z.string().min(32)
+});
+var DeviceTypeSchema = z.enum([
+  "iot-gateway",
+  "wifiIndoor",
+  "wifiOutdoor",
+  "wifiDataOnly",
+  "cbrs"
+]);
+var OwnershipTypeSchema = z.enum(["owner", "direct", "fanout", "all"]);
+var HotspotSharesSchema = z.object({
+  fixed: z.string().optional(),
+  percentage: z.number().optional()
+});
+var 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()
+});
 var HotspotsDataSchema = z.object({
   hotspots: z.array(HotspotSchema),
   total: z.number(),
@@ -256,6 +281,68 @@ var DeleteSplitOutputSchema = z.object({
 var PendingRewardsOutputSchema = z.object({
   pending: z.string()
 });
+var AutomationStatusOutputSchema = z.object({
+  hasExistingAutomation: z.boolean(),
+  isOutOfSol: z.boolean(),
+  currentSchedule: z.object({
+    schedule: AutomationScheduleSchema,
+    time: z.string(),
+    nextRun: z.string()
+    // ISO date string
+  }).optional(),
+  rentFee: z.number(),
+  recipientFee: z.number(),
+  solFee: z.number(),
+  remainingClaims: z.number().optional(),
+  fundingPeriodInfo: z.object({
+    periodLength: AutomationScheduleSchema,
+    periodsRemaining: z.number(),
+    // Minimum of both pools
+    cronJobPeriodsRemaining: z.number(),
+    pdaWalletPeriodsRemaining: z.number()
+  }).optional(),
+  cronJobBalance: z.string(),
+  // lamports as string
+  pdaWalletBalance: z.string()
+  // lamports as string
+});
+var SetupAutomationOutputSchema = z.object({
+  transactionData: TransactionDataSchema
+});
+var FundAutomationOutputSchema = z.object({
+  transactionData: TransactionDataSchema
+});
+var CloseAutomationOutputSchema = z.object({
+  transactionData: TransactionDataSchema
+});
+var FundingEstimateOutputSchema = z.object({
+  cronJobFunding: z.number(),
+  // SOL needed for cron job account
+  pdaWalletFunding: z.number(),
+  // SOL needed for PDA wallet
+  recipientFee: z.number(),
+  // SOL needed for recipient accounts (if any)
+  totalFunding: z.number(),
+  // Total SOL needed
+  currentCronJobBalance: z.string(),
+  // Current balance in cronJob (lamports as string)
+  currentPdaWalletBalance: z.string(),
+  // Current balance in pdaWallet (lamports as string)
+  additionalFundingNeeded: z.number()
+  // Net additional funding required (SOL)
+});
+var ReassertLocationRequestSchema = z.object({
+  entityPubKey: HeliumPublicKeySchema,
+  walletAddress: WalletAddressSchema,
+  location: z.object({
+    lat: z.number().min(-90).max(90),
+    lng: z.number().min(-180).max(180)
+  }),
+  azimuth: z.number().min(0).max(360).optional()
+});
+var ReassertLocationResponseSchema = z.object({
+  transactionData: TransactionDataSchema
+});
 var GetTokensInputSchema = z.object({
   limit: z.coerce.number().int().min(1).max(100).default(50)
 });
@@ -390,10 +477,10 @@ var PayerBatchesOutputSchema = z.object({
   })
 });
 var WelcomePackListInputSchema = z.object({
-  walletAddress: z.string().min(32)
+  walletAddress: WalletAddressSchema
 });
 var WelcomePackCreateInputSchema = z.object({
-  walletAddress: z.string().min(32),
+  walletAddress: WalletAddressSchema,
   assetId: z.string(),
   solAmount: z.number(),
   rentRefund: z.string(),
@@ -403,11 +490,11 @@ var WelcomePackCreateInputSchema = z.object({
   lazyDistributor: z.string()
 });
 var WelcomePackGetInputSchema = z.object({
-  walletAddress: z.string().min(32),
+  walletAddress: WalletAddressSchema,
   packId: z.number()
 });
 var WelcomePackDeleteInputSchema = z.object({
-  walletAddress: z.string().min(32),
+  walletAddress: WalletAddressSchema,
   packId: z.number()
 });
 var WelcomePackGetByAddressInputSchema = z.object({
@@ -415,13 +502,13 @@ var WelcomePackGetByAddressInputSchema = z.object({
 });
 var WelcomePackClaimInputSchema = z.object({
   packAddress: z.string().min(32),
-  walletAddress: z.string().min(32),
+  walletAddress: WalletAddressSchema,
   signature: z.string(),
   expirationTs: z.string()
 });
 var WelcomePackInviteInputSchema = z.object({
   packAddress: z.string().min(32),
-  walletAddress: z.string().min(32),
+  walletAddress: WalletAddressSchema,
   expirationDays: z.number().int().positive().max(365).default(7)
 });
 var WelcomePackSchema = z.object({
@@ -475,6 +562,10 @@ var BAD_REQUEST = {
     fields: z.array(z.string()).optional()
   }).optional()
 };
+var INVALID_WALLET_ADDRESS = {
+  status: 400,
+  message: "The provided wallet address is invalid."
+};
 var RATE_LIMITED = {
   status: 429,
   message: "Too many requests. Please try again later."
@@ -507,139 +598,157 @@ var SIMULATION_FAILED = {
     link: z.string().optional()
   })
 };
-var protectedOc = oc.errors({
-  UNAUTHENTICATED,
-  UNAUTHORIZED
-});
-var publicOc = oc.errors({
-  INVALID_WALLET_ADDRESS: { message: "Invalid wallet address", status: 400 }
+var healthContract = oc.tag("Health").router({
+  check: oc.route({ method: "GET", path: "/health", summary: "Health check" }).output(HealthResponseSchema)
 });
-
-// src/contracts/health.ts
-var healthContract = {
-  check: publicOc.route({ method: "GET", path: "/health", tags: ["Health"], summary: "Health check" }).output(HealthResponseSchema)
-};
-
-// src/contracts/tokens.ts
-var tokensContract = {
+var tokensContract = oc.tag("Tokens").router({
   /** Public: Get token balances for a wallet */
-  getBalances: publicOc.route({ method: "GET", path: "/tokens/{walletAddress}", tags: ["Tokens"], summary: "Get token balances for a wallet" }).input(GetBalancesInputSchema).output(TokenBalanceDataSchema).errors({}),
+  getBalances: oc.route({ method: "GET", path: "/tokens/{walletAddress}", summary: "Get token balances for a wallet" }).input(GetBalancesInputSchema).output(TokenBalanceDataSchema).errors({
+    INVALID_WALLET_ADDRESS
+  }),
   /** Protected: Transfer tokens */
-  transfer: publicOc.route({ method: "POST", path: "/tokens/transfer", tags: ["Tokens"], summary: "Transfer tokens" }).input(TransferInputSchema).output(TransferOutputSchema).errors({
+  transfer: oc.route({ method: "POST", path: "/tokens/transfer", summary: "Transfer tokens" }).input(TransferInputSchema).output(TransferOutputSchema).errors({
     BAD_REQUEST,
     INSUFFICIENT_FUNDS
   }),
   /** Protected: Create HNT account */
-  createHntAccount: publicOc.route({ method: "POST", path: "/tokens/hnt-account", tags: ["Tokens"], summary: "Create HNT account" }).input(CreateHntAccountInputSchema).output(CreateHntAccountOutputSchema).errors({})
-};
-
-// src/contracts/hotspots.ts
-var hotspotsContract = {
+  createHntAccount: oc.route({ method: "POST", path: "/tokens/hnt-account", summary: "Create HNT account" }).input(CreateHntAccountInputSchema).output(CreateHntAccountOutputSchema).errors({
+    INVALID_WALLET_ADDRESS
+  })
+});
+var hotspotsContract = oc.tag("Hotspot").prefix("/hotspots").router({
   /** Public: Get hotspots for a wallet */
-  getHotspots: publicOc.route({ method: "GET", path: "/hotspots/wallet/{walletAddress}", tags: ["Hotspots"], summary: "Get hotspots for a wallet" }).input(GetHotspotsInputSchema).output(HotspotsDataSchema).errors({}),
+  getHotspots: oc.route({ method: "GET", path: "/wallet/{walletAddress}", summary: "Get hotspots for a wallet" }).input(GetHotspotsInputSchema).output(HotspotsDataSchema).errors({
+    INVALID_WALLET_ADDRESS
+  }),
   /** Protected: Claim rewards for hotspots */
-  claimRewards: publicOc.route({ method: "POST", path: "/hotspots/claim-rewards", tags: ["Hotspots"], summary: "Claim all hotspot rewards" }).input(ClaimRewardsInputSchema).output(ClaimRewardsOutputSchema).errors({
+  claimRewards: oc.route({ method: "POST", path: "/claim-rewards", summary: "Claim all hotspot rewards" }).input(ClaimRewardsInputSchema).output(ClaimRewardsOutputSchema).errors({
     INSUFFICIENT_FUNDS
   }),
   /** Public: Get pending rewards for a wallet */
-  getPendingRewards: publicOc.route({ method: "GET", path: "/hotspots/pending-rewards/{walletAddress}", tags: ["Hotspots"], summary: "Get pending rewards" }).input(GetPendingRewardsInputSchema).output(PendingRewardsOutputSchema).errors({
-    BAD_REQUEST: { message: "Invalid wallet address", status: 400 }
+  getPendingRewards: oc.route({ method: "GET", path: "/pending-rewards/{walletAddress}", summary: "Get pending rewards" }).input(GetPendingRewardsInputSchema).output(PendingRewardsOutputSchema).errors({
+    BAD_REQUEST: { message: "Invalid wallet address", status: 400 },
+    INVALID_WALLET_ADDRESS
   }),
   /** Protected: Transfer hotspot ownership */
-  transferHotspot: publicOc.route({ method: "POST", path: "/hotspots/transfer", tags: ["Hotspots"], summary: "Transfer ownership" }).input(TransferHotspotInputSchema).output(TransferHotspotOutputSchema).errors({
+  transferHotspot: oc.route({ method: "POST", path: "/transfer", summary: "Transfer ownership" }).input(TransferHotspotInputSchema).output(TransferHotspotOutputSchema).errors({
     UNAUTHORIZED,
     NOT_FOUND,
     BAD_REQUEST: { message: "Invalid transfer parameters", status: 400 }
   }),
   /** Protected: Update rewards destination */
-  updateRewardsDestination: publicOc.route({ method: "POST", path: "/hotspots/update-rewards-destination", tags: ["Hotspots"], summary: "Update rewards destination" }).input(UpdateRewardsDestinationInputSchema).output(UpdateRewardsDestinationOutputSchema).errors({
+  updateRewardsDestination: oc.route({ method: "POST", path: "/update-rewards-destination", summary: "Update rewards destination" }).input(UpdateRewardsDestinationInputSchema).output(UpdateRewardsDestinationOutputSchema).errors({
     BAD_REQUEST: { message: "Invalid parameters", status: 400 },
     NOT_FOUND
   }),
   /** Public: Get split configuration for a hotspot */
-  getSplit: publicOc.route({ method: "GET", path: "/hotspots/split/{walletAddress}/{hotspotPubkey}", tags: ["Hotspots"], summary: "Get reward split" }).input(GetSplitInputSchema).output(SplitResponseSchema).errors({
-    NOT_FOUND: { message: "Split not found", status: 404 }
+  getSplit: oc.route({ method: "GET", path: "/split/{walletAddress}/{hotspotPubkey}", summary: "Get reward split" }).input(GetSplitInputSchema).output(SplitResponseSchema).errors({
+    NOT_FOUND: { message: "Split not found", status: 404 },
+    INVALID_WALLET_ADDRESS
   }),
   /** Protected: Create a split configuration */
-  createSplit: publicOc.route({ method: "POST", path: "/hotspots/split", tags: ["Hotspots"], summary: "Create a reward split" }).input(CreateSplitInputSchema).output(CreateSplitOutputSchema).errors({
+  createSplit: oc.route({ method: "POST", path: "/split", summary: "Create a reward split" }).input(CreateSplitInputSchema).output(CreateSplitOutputSchema).errors({
     NOT_FOUND,
     BAD_REQUEST: { message: "Invalid split configuration", status: 400 },
     INSUFFICIENT_FUNDS
   }),
   /** Protected: Delete a split configuration */
-  deleteSplit: publicOc.route({ method: "DELETE", path: "/hotspots/split", tags: ["Hotspots"], summary: "Delete a reward split" }).input(DeleteSplitInputSchema).output(DeleteSplitOutputSchema).errors({
+  deleteSplit: oc.route({ method: "DELETE", path: "/split", summary: "Delete a reward split" }).input(DeleteSplitInputSchema).output(DeleteSplitOutputSchema).errors({
+    NOT_FOUND
+  }),
+  /** Protected: Close automation */
+  closeAutomation: oc.route({ method: "POST", path: "/hotspots/wallet/{walletAddress}/automation/close", summary: "Close automation" }).input(CloseAutomationInputSchema).output(CloseAutomationOutputSchema).errors({
+    NOT_FOUND
+  }),
+  /** Protected: Get automation status */
+  getAutomationStatus: oc.route({ method: "GET", path: "/hotspots/wallet/{walletAddress}/automation/status", summary: "Get automation status" }).input(GetAutomationStatusInputSchema).output(AutomationStatusOutputSchema).errors({
+    NOT_FOUND
+  }),
+  /** Protected: Create automation */
+  createAutomation: oc.route({
+    method: "POST",
+    path: "/hotspots/wallet/{walletAddress}/automation",
+    summary: "Setup automation"
+  }).input(SetupAutomationInputSchema).output(SetupAutomationOutputSchema).errors({
+    NOT_FOUND
+  }),
+  /** Protected: Fund automation */
+  fundAutomation: oc.route({ method: "POST", path: "/hotspots/wallet/{walletAddress}/automation/fund", summary: "Fund automation" }).input(FundAutomationInputSchema).output(FundAutomationOutputSchema).errors({
+    NOT_FOUND,
+    INSUFFICIENT_FUNDS
+  }),
+  /** Protected: Get funding estimate */
+  getFundingEstimate: oc.route({ method: "GET", path: "/hotspots/wallet/{walletAddress}/automation/funding-estimate", summary: "Get funding estimate" }).input(GetFundingEstimateInputSchema).output(FundingEstimateOutputSchema).errors({
     NOT_FOUND
   })
-};
-
-// src/contracts/swap.ts
-var swapContract = {
-  getTokens: publicOc.route({ method: "GET", path: "/swap/tokens", tags: ["Swap"] }).input(GetTokensInputSchema).output(TokenListOutputSchema).errors({
+});
+var swapContract = oc.tag("Swap").router({
+  getTokens: oc.route({ method: "GET", path: "/swap/tokens" }).input(GetTokensInputSchema).output(TokenListOutputSchema).errors({
     JUPITER_ERROR: { message: "Failed to fetch tokens from Jupiter" }
   }),
-  getQuote: publicOc.route({ method: "GET", path: "/swap/quote", tags: ["Swap"] }).input(GetQuoteInputSchema).output(QuoteResponseSchema).errors({
+  getQuote: oc.route({ method: "GET", path: "/swap/quote" }).input(GetQuoteInputSchema).output(QuoteResponseSchema).errors({
     BAD_REQUEST: { message: "Invalid quote parameters", status: 400 },
     JUPITER_ERROR: { message: "Failed to get quote from Jupiter" }
   }),
-  getInstructions: publicOc.route({ method: "POST", path: "/swap/instructions", tags: ["Swap"] }).input(GetInstructionsInputSchema).output(TransactionDataSchema).errors({
+  getInstructions: oc.route({ method: "POST", path: "/swap/instructions" }).input(GetInstructionsInputSchema).output(TransactionDataSchema).errors({
     BAD_REQUEST: { message: "Invalid instruction parameters", status: 400 },
     JUPITER_ERROR: { message: "Failed to get swap instructions from Jupiter" }
   })
-};
-
-// src/contracts/transactions.ts
-var transactionsContract = {
-  submit: publicOc.route({ method: "POST", path: "/transactions", tags: ["Transactions"], summary: "Submit a transaction" }).input(SubmitInputSchema).output(SubmitOutputSchema).errors({
+});
+var transactionsContract = oc.tag("Transactions").router({
+  submit: oc.route({ method: "POST", path: "/transactions", summary: "Submit a transaction" }).input(SubmitInputSchema).output(SubmitOutputSchema).errors({
     BAD_REQUEST,
     CONFLICT,
     SIMULATION_FAILED
   }),
-  get: publicOc.route({ method: "GET", path: "/transactions/{id}", tags: ["Transactions"], summary: "Get transaction status" }).input(GetInputSchema).output(BatchStatusOutputSchema).errors({
+  get: oc.route({ method: "GET", path: "/transactions/{id}", summary: "Get transaction status" }).input(GetInputSchema).output(BatchStatusOutputSchema).errors({
     NOT_FOUND
   }),
-  resubmit: publicOc.route({ method: "POST", path: "/transactions/{id}/resubmit", tags: ["Transactions"], summary: "Resubmit a transaction" }).input(ResubmitInputSchema).output(ResubmitOutputSchema).errors({
+  resubmit: oc.route({ method: "POST", path: "/transactions/{id}/resubmit", summary: "Resubmit a transaction" }).input(ResubmitInputSchema).output(ResubmitOutputSchema).errors({
     NOT_FOUND,
     BAD_REQUEST
   }),
-  getByPayer: publicOc.route({ method: "GET", path: "/transactions/payer/{payer}", tags: ["Transactions"], summary: "Get transactions by payer" }).input(GetByPayerInputSchema).output(PayerBatchesOutputSchema).errors({
+  getByPayer: oc.route({ method: "GET", path: "/transactions/payer/{payer}", summary: "Get transactions by payer" }).input(GetByPayerInputSchema).output(PayerBatchesOutputSchema).errors({
     BAD_REQUEST
   }),
-  getByPayerAndTag: publicOc.route({ method: "GET", path: "/transactions/payer/{payer}/tag/{tag}", tags: ["Transactions"], summary: "Get transactions by payer and tag" }).input(GetByPayerAndTagInputSchema).output(PayerBatchesOutputSchema).errors({
+  getByPayerAndTag: oc.route({ method: "GET", path: "/transactions/payer/{payer}/tag/{tag}", summary: "Get transactions by payer and tag" }).input(GetByPayerAndTagInputSchema).output(PayerBatchesOutputSchema).errors({
     BAD_REQUEST
   })
-};
-
-// src/contracts/welcome-packs.ts
-var welcomePacksContract = {
+});
+var welcomePacksContract = oc.tag("Welcome Packs").router({
   /** Public: List welcome packs for a wallet */
-  list: publicOc.route({ method: "GET", path: "/welcome-packs/{walletAddress}", tags: ["Welcome Packs"], summary: "List welcome packs for a wallet" }).input(WelcomePackListInputSchema).output(WelcomePackListOutputSchema).errors({}),
+  list: oc.route({ method: "GET", path: "/welcome-packs/{walletAddress}", summary: "List welcome packs for a wallet" }).input(WelcomePackListInputSchema).output(WelcomePackListOutputSchema).errors({
+    INVALID_WALLET_ADDRESS
+  }),
   /** Protected: Create a new welcome pack */
-  create: publicOc.route({ method: "POST", path: "/welcome-packs", tags: ["Welcome Packs"], summary: "Create a new welcome pack" }).input(WelcomePackCreateInputSchema).output(WelcomePackCreateOutputSchema).errors({
+  create: oc.route({ method: "POST", path: "/welcome-packs", summary: "Create a new welcome pack" }).input(WelcomePackCreateInputSchema).output(WelcomePackCreateOutputSchema).errors({
     BAD_REQUEST
   }),
   /** Public: Get a specific welcome pack */
-  get: publicOc.route({ method: "GET", path: "/welcome-packs/{walletAddress}/{packId}", tags: ["Welcome Packs"], summary: "Get a specific welcome pack" }).input(WelcomePackGetInputSchema).output(WelcomePackSchema).errors({
-    NOT_FOUND
+  get: oc.route({ method: "GET", path: "/welcome-packs/{walletAddress}/{packId}", summary: "Get a specific welcome pack" }).input(WelcomePackGetInputSchema).output(WelcomePackSchema).errors({
+    NOT_FOUND,
+    INVALID_WALLET_ADDRESS
   }),
   /** Protected: Delete a welcome pack */
-  delete: publicOc.route({ method: "DELETE", path: "/welcome-packs/{walletAddress}/{packId}", tags: ["Welcome Packs"], summary: "Delete a welcome pack" }).input(WelcomePackDeleteInputSchema).output(WelcomePackDeleteOutputSchema).errors({
-    BAD_REQUEST
+  delete: oc.route({ method: "DELETE", path: "/welcome-packs/{walletAddress}/{packId}", summary: "Delete a welcome pack" }).input(WelcomePackDeleteInputSchema).output(WelcomePackDeleteOutputSchema).errors({
+    BAD_REQUEST,
+    INVALID_WALLET_ADDRESS
   }),
   /** Public: Get welcome pack by pack address */
-  getByAddress: publicOc.route({ method: "GET", path: "/welcome-packs/address/{packAddress}", tags: ["Welcome Packs"], summary: "Get welcome pack by pack address" }).input(WelcomePackGetByAddressInputSchema).output(WelcomePackSchema).errors({
+  getByAddress: oc.route({ method: "GET", path: "/welcome-packs/address/{packAddress}", summary: "Get welcome pack by pack address" }).input(WelcomePackGetByAddressInputSchema).output(WelcomePackSchema).errors({
     NOT_FOUND
   }),
   /** Public: Claim a welcome pack (no auth needed, uses claim token) */
-  claim: publicOc.route({ method: "POST", path: "/welcome-packs/claim", tags: ["Welcome Packs"], summary: "Claim a welcome pack" }).input(WelcomePackClaimInputSchema).output(WelcomePackClaimOutputSchema).errors({
+  claim: oc.route({ method: "POST", path: "/welcome-packs/claim", summary: "Claim a welcome pack" }).input(WelcomePackClaimInputSchema).output(WelcomePackClaimOutputSchema).errors({
     BAD_REQUEST,
     EXPIRED: { message: "Claim link has expired", status: 410 }
   }),
   /** Protected: Send an invite for a welcome pack */
-  invite: publicOc.route({ method: "POST", path: "/welcome-packs/invite", tags: ["Welcome Packs"], summary: "Send an invite for a welcome pack" }).input(WelcomePackInviteInputSchema).output(WelcomePackInviteOutputSchema).errors({
+  invite: oc.route({ method: "POST", path: "/welcome-packs/invite", summary: "Send an invite for a welcome pack" }).input(WelcomePackInviteInputSchema).output(WelcomePackInviteOutputSchema).errors({
     BAD_REQUEST,
     NOT_FOUND
   })
-};
+});
 var InitKycInputSchema = z.object({
   type: z.enum(["individual", "business"]).optional()
 });
@@ -732,41 +841,42 @@ var UpdateTransferOutputSchema = z.object({
   success: z.boolean()
 });
 var QuoteOutputSchema = QuoteResponseSchema;
-
-// src/contracts/fiat.ts
-var fiatContract = {
-  getKycStatus: protectedOc.route({ method: "GET", path: "/fiat/kyc/status" }).output(KycStatusOutputSchema).errors({
+var fiatContract = oc.errors({
+  UNAUTHENTICATED,
+  UNAUTHORIZED
+}).tag("Fiat").router({
+  getKycStatus: oc.route({ method: "GET", path: "/fiat/kyc/status" }).output(KycStatusOutputSchema).errors({
     EMAIL_NOT_LINKED: { status: 401, message: "Email not linked." }
   }),
-  initKyc: protectedOc.route({ method: "POST", path: "/fiat/kyc/init" }).input(InitKycInputSchema).output(KycStatusOutputSchema).errors({
+  initKyc: oc.route({ method: "POST", path: "/fiat/kyc/init" }).input(InitKycInputSchema).output(KycStatusOutputSchema).errors({
     EMAIL_NOT_LINKED: { status: 401, message: "Email not linked." },
     BRIDGE_ERROR: { message: "Failed to create Bridge KYC link", status: 500 }
   }),
-  getFees: protectedOc.route({ method: "GET", path: "/fiat/fees" }).output(FeesOutputSchema).errors({}),
-  listBankAccounts: protectedOc.route({ method: "GET", path: "/fiat/bank-accounts" }).output(BankAccountListOutputSchema).errors({
+  getFees: oc.route({ method: "GET", path: "/fiat/fees" }).output(FeesOutputSchema).errors({}),
+  listBankAccounts: oc.route({ method: "GET", path: "/fiat/bank-accounts" }).output(BankAccountListOutputSchema).errors({
     NOT_FOUND: { message: "Bridge customer ID not found", status: 404 }
   }),
-  createBankAccount: protectedOc.route({ method: "POST", path: "/fiat/bank-accounts" }).input(CreateBankAccountInputSchema).output(BankAccountSchema).errors({
+  createBankAccount: oc.route({ method: "POST", path: "/fiat/bank-accounts" }).input(CreateBankAccountInputSchema).output(BankAccountSchema).errors({
     NO_CUSTOMER: { message: "Bridge customer ID not found", status: 404 },
     BRIDGE_ERROR: { message: "Failed to create Bridge KYC link", status: 500 }
   }),
-  deleteBankAccount: protectedOc.route({ method: "DELETE", path: "/fiat/bank-accounts/{id}" }).input(DeleteBankAccountInputSchema).output(DeleteBankAccountOutputSchema).errors({
+  deleteBankAccount: oc.route({ method: "DELETE", path: "/fiat/bank-accounts/{id}" }).input(DeleteBankAccountInputSchema).output(DeleteBankAccountOutputSchema).errors({
     NO_CUSTOMER: { message: "Bridge customer ID not found", status: 404 },
     BRIDGE_ERROR: { message: "Failed to delete bank account", status: 500 }
   }),
-  getSendQuote: protectedOc.route({ method: "GET", path: "/fiat/quote/{id}" }).input(GetSendQuoteInputSchema).output(QuoteOutputSchema).errors({
+  getSendQuote: oc.route({ method: "GET", path: "/fiat/quote/{id}" }).input(GetSendQuoteInputSchema).output(QuoteOutputSchema).errors({
     BAD_REQUEST,
     JUPITER_ERROR: { message: "Failed to get quote from Jupiter", status: 500 }
   }),
-  sendFunds: protectedOc.route({ method: "POST", path: "/fiat/send" }).input(SendFundsInputSchema).output(SendFundsOutputSchema).errors({
+  sendFunds: oc.route({ method: "POST", path: "/fiat/send" }).input(SendFundsInputSchema).output(SendFundsOutputSchema).errors({
     NOT_FOUND,
     BRIDGE_ERROR: { message: "Failed to create Bridge transfer", status: 500 },
     JUPITER_ERROR: { message: "Failed to get quote from Jupiter", status: 500 }
   }),
-  updateTransfer: protectedOc.route({ method: "PUT", path: "/fiat/transfer/{id}" }).input(UpdateTransferInputSchema).output(UpdateTransferOutputSchema).errors({
+  updateTransfer: oc.route({ method: "PUT", path: "/fiat/transfer/{id}" }).input(UpdateTransferInputSchema).output(UpdateTransferOutputSchema).errors({
     NOT_FOUND: { message: "Transfer not found", status: 404 }
   })
-};
+});
 var BridgeWebhookInputSchema = z.object({
   type: z.string(),
   kyc_link_id: z.string().optional(),
@@ -780,26 +890,24 @@ var BridgeWebhookOutputSchema = z.object({
 });
 
 // src/contracts/webhooks.ts
-var webhooksContract = {
-  bridge: publicOc.route({ method: "POST", path: "/webhooks/bridge" }).input(BridgeWebhookInputSchema).output(BridgeWebhookOutputSchema).errors({
+var webhooksContract = oc.tag("Webhooks").router({
+  bridge: oc.route({ method: "POST", path: "/webhooks/bridge" }).input(BridgeWebhookInputSchema).output(BridgeWebhookOutputSchema).errors({
     NOT_FOUND,
     INVALID_PAYLOAD: { message: "Invalid webhook payload", status: 400 }
   })
-};
-
-// src/contracts/index.ts
-var apiContract = {
+});
+var apiContract = oc.router({
   health: healthContract,
   tokens: tokensContract,
   hotspots: hotspotsContract,
   swap: swapContract,
   transactions: transactionsContract,
   welcomePacks: welcomePacksContract
-};
-var fullApiContract = {
+});
+var fullApiContract = oc.router({
   ...apiContract,
   fiat: fiatContract,
   webhooks: webhooksContract
-};
+});
 
-export { BAD_REQUEST, BatchStatusOutputSchema, CONFLICT, ClaimRewardsInputSchema, ClaimRewardsOutputSchema, CreateHntAccountInputSchema, CreateHntAccountOutputSchema, CreateSplitInputSchema, CreateSplitOutputSchema, DeleteSplitInputSchema, DeleteSplitOutputSchema, DeviceTypeSchema, ErrorResponseSchema, GetBalancesInputSchema, GetByPayerAndTagInputSchema, GetByPayerInputSchema, GetHotspotsInputSchema, GetInputSchema, GetInstructionsInputSchema, GetPendingRewardsInputSchema, GetQuoteInputSchema, GetSplitInputSchema, GetTokensInputSchema, HealthResponseSchema, HotspotSchema, HotspotSharesSchema, HotspotTypeSchema, HotspotsDataSchema, INSUFFICIENT_FUNDS, NOT_FOUND, OwnershipTypeSchema, PaginationInputSchema, PaginationOutputSchema, PayerBatchSummarySchema, PayerBatchesOutputSchema, PendingRewardsOutputSchema, PublicKeySchema, QuoteResponseSchema, RATE_LIMITED, ResubmitInputSchema, ResubmitOutputSchema, RewardSplitInputSchema, SIMULATION_FAILED, ScheduleInputSchema, SplitResponseSchema, SplitShareSchema, SubmitInputSchema, SubmitOutputSchema, SwapTransactionDataSchema, TRANSACTION_FAILED, TokenAccountSchema, TokenBalanceDataSchema, TokenListOutputSchema, TokenSchema, TransactionBatchRequestSchema, TransactionBatchResponseSchema, TransactionDataSchema, TransactionItemSchema, TransactionMetadataSchema, TransactionStatusSchema, TransferHotspotInputSchema, TransferHotspotOutputSchema, TransferInputSchema, TransferOutputSchema, UNAUTHENTICATED, UNAUTHORIZED, UpdateRewardsDestinationInputSchema, UpdateRewardsDestinationOutputSchema, WalletAddressSchema, WelcomePackClaimInputSchema, WelcomePackClaimOutputSchema, WelcomePackCreateInputSchema, WelcomePackCreateOutputSchema, WelcomePackDeleteInputSchema, WelcomePackDeleteOutputSchema, WelcomePackGetByAddressInputSchema, WelcomePackGetInputSchema, WelcomePackInviteInputSchema, WelcomePackInviteOutputSchema, WelcomePackListInputSchema, WelcomePackListOutputSchema, WelcomePackSchema, apiContract, createClient, createMockClient, fullApiContract };
+export { AutomationScheduleSchema, AutomationStatusOutputSchema, BAD_REQUEST, BatchStatusOutputSchema, CONFLICT, ClaimRewardsInputSchema, ClaimRewardsOutputSchema, CloseAutomationInputSchema, CloseAutomationOutputSchema, CreateHntAccountInputSchema, CreateHntAccountOutputSchema, CreateSplitInputSchema, CreateSplitOutputSchema, DeleteSplitInputSchema, DeleteSplitOutputSchema, DeviceTypeSchema, ErrorResponseSchema, FundAutomationInputSchema, FundAutomationOutputSchema, FundingEstimateOutputSchema, GetAutomationStatusInputSchema, GetBalancesInputSchema, GetByPayerAndTagInputSchema, GetByPayerInputSchema, GetFundingEstimateInputSchema, GetHotspotsInputSchema, GetInputSchema, GetInstructionsInputSchema, GetPendingRewardsInputSchema, GetQuoteInputSchema, GetSplitInputSchema, GetTokensInputSchema, HealthResponseSchema, HeliumPublicKeySchema, HotspotSchema, HotspotSharesSchema, HotspotTypeSchema, HotspotsDataSchema, INSUFFICIENT_FUNDS, INVALID_WALLET_ADDRESS, NOT_FOUND, OwnershipTypeSchema, PaginationInputSchema, PaginationOutputSchema, PayerBatchSummarySchema, PayerBatchesOutputSchema, PendingRewardsOutputSchema, PublicKeySchema, QuoteResponseSchema, RATE_LIMITED, ReassertLocationRequestSchema, ReassertLocationResponseSchema, ResubmitInputSchema, ResubmitOutputSchema, RewardSplitInputSchema, SIMULATION_FAILED, ScheduleInputSchema, SetupAutomationInputSchema, SetupAutomationOutputSchema, SplitResponseSchema, SplitShareSchema, SubmitInputSchema, SubmitOutputSchema, SwapTransactionDataSchema, TRANSACTION_FAILED, TokenAccountSchema, TokenBalanceDataSchema, TokenListOutputSchema, TokenSchema, TransactionBatchRequestSchema, TransactionBatchResponseSchema, TransactionDataSchema, TransactionItemSchema, TransactionMetadataSchema, TransactionStatusSchema, TransferHotspotInputSchema, TransferHotspotOutputSchema, TransferInputSchema, TransferOutputSchema, UNAUTHENTICATED, UNAUTHORIZED, UpdateRewardsDestinationInputSchema, UpdateRewardsDestinationOutputSchema, WalletAddressSchema, WelcomePackClaimInputSchema, WelcomePackClaimOutputSchema, WelcomePackCreateInputSchema, WelcomePackCreateOutputSchema, WelcomePackDeleteInputSchema, WelcomePackDeleteOutputSchema, WelcomePackGetByAddressInputSchema, WelcomePackGetInputSchema, WelcomePackInviteInputSchema, WelcomePackInviteOutputSchema, WelcomePackListInputSchema, WelcomePackListOutputSchema, WelcomePackSchema, apiContract, createClient, createMockClient, fullApiContract };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helium/blockchain-api",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "TypeScript client and schemas for the Helium Blockchain API",
   "license": "Apache-2.0",
   "repository": {