@boundlessfi/identity-sdk 0.1.1

package/src/constants.ts

@@ -0,0 +1,37 @@
+export const NETWORK_CONFIGS = {
+  testnet: {
+    networkPassphrase: "Test SDF Network ; September 2015",
+    defaultRpcUrl: "https://soroban-testnet.stellar.org",
+    accountWasmHash:
+      "a12e8fa9621efd20315753bd4007d974390e31fbcb4a7ddc4dd0a0dec728bf2e",
+    webauthnVerifierAddress:
+      "CBSHV66WG7UV6FQVUTB67P3DZUEJ2KJ5X6JKQH5MFRAAFNFJUAJVXJYV",
+    ed25519VerifierAddress:
+      "CDGMOL3BP6Y6LYOXXTRNXBNJ2SLNTQ47BGG3LOS2OBBE657E3NYCN54B",
+    nativeTokenContract:
+      "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC",
+    policies: {
+      threshold: "CCT4MMN5MJ6O2OU6LXPYTCVORQ2QVTBMDJ7MYBZQ2ULSYQVUIYP4IFYD",
+      spendingLimit: "CBMMWY54XOV6JJHSWCMKWWPXVRXASR5U26UJMLZDN4SP6CFFTVZARPTY",
+      weightedThreshold:
+        "CBYDQ5XUBP7G24FI3LLGLW56QZCIEUSVRPX7FVOUCKHJQQ6DTF6BQGBZ",
+    },
+    relayerUrl: "",
+  },
+  mainnet: {
+    networkPassphrase: "Public Global Stellar Network ; September 2015",
+    defaultRpcUrl: "https://soroban-rpc.mainnet.stellar.org",
+    accountWasmHash: "REPLACE_WITH_MAINNET_WASM_HASH",
+    webauthnVerifierAddress: "REPLACE_WITH_MAINNET_VERIFIER",
+    ed25519VerifierAddress: "REPLACE_WITH_MAINNET_VERIFIER",
+    nativeTokenContract: "REPLACE_WITH_MAINNET_CONTRACT",
+    policies: {
+      threshold: "REPLACE_WITH_MAINNET_POLICY",
+      spendingLimit: "REPLACE_WITH_MAINNET_POLICY",
+      weightedThreshold: "REPLACE_WITH_MAINNET_POLICY",
+    },
+    relayerUrl: "",
+  },
+} as const;
+
+export type NetworkName = keyof typeof NETWORK_CONFIGS;

package/src/errors.ts

@@ -0,0 +1,18 @@
+import { SmartAccountError } from "smart-account-kit";
+
+export class BoundlessAuthError extends SmartAccountError {
+  constructor(message: string) {
+    super(message, "BOUNDLESS_AUTH" as any);
+    this.name = "BoundlessAuthError";
+  }
+}
+
+export class BoundlessLinkError extends SmartAccountError {
+  constructor(
+    message: string,
+    public statusCode?: number,
+  ) {
+    super(message, "BOUNDLESS_LINK" as any);
+    this.name = "BoundlessLinkError";
+  }
+}

package/src/index.ts

@@ -0,0 +1,17 @@
+export * from "./boundless-sdk";
+export * from "./types";
+export * from "./errors";
+export * from "./constants";
+export * from "./utils";
+export {
+  SmartAccountError,
+  WalletNotConnectedError,
+  CredentialNotFoundError,
+  SignerNotFoundError,
+  SimulationError,
+  SubmissionError,
+  ValidationError,
+  WebAuthnError,
+  SessionError,
+  wrapError,
+} from "smart-account-kit";

package/src/server/index.ts

@@ -0,0 +1 @@
+export { boundlessStellarPlugin } from "./stellar-plugin";

package/src/server/stellar-plugin.ts

@@ -0,0 +1,66 @@
+import type { BetterAuthPlugin } from "better-auth";
+
+export const boundlessStellarPlugin = (): BetterAuthPlugin =>
+  ({
+    id: "boundless-stellar",
+
+    schema: {
+      user: {
+        fields: {
+          stellarAddress: {
+            type: "string",
+            required: false,
+            unique: true,
+          },
+          credentialId: {
+            type: "string",
+            required: false,
+          },
+        },
+      },
+    },
+
+    endpoints: {
+      linkStellar: {
+        path: "/stellar/link",
+        method: ["POST"],
+        handler: async (ctx: any) => {
+          // ctx is the Better-Auth handler context.
+          // ctx.request.body contains the parsed JSON.
+          // ctx.context.db  is the database adapter.
+          // ctx.context.session.user is the authenticated user (or null).
+
+          const session = await ctx.context.auth.getSession(ctx.request);
+          if (!session?.user) {
+            return ctx.json({ error: "Unauthorized" }, { status: 401 });
+          }
+
+          const body = ctx.request.body as { stellarAddress?: unknown };
+          const { stellarAddress } = body;
+
+          // Validate C-address format
+          if (
+            typeof stellarAddress !== "string" ||
+            stellarAddress.length !== 56 ||
+            !stellarAddress.startsWith("C")
+          ) {
+            return ctx.json(
+              {
+                error:
+                  "Invalid stellarAddress. Must be a 56-char Soroban contract ID starting with C.",
+              },
+              { status: 400 },
+            );
+          }
+
+          // Persist
+          await ctx.context.db.update("user", {
+            where: { id: session.user.id },
+            update: { stellarAddress },
+          });
+
+          return ctx.json({ success: true });
+        },
+      },
+    },
+  }) as any;

package/src/types.ts

@@ -0,0 +1,75 @@
+// Re-export upstream types the consuming app will need.
+// Declare Boundless-specific types below.
+
+// ── re-exports from smart-account-kit ──────────────────────────
+
+export type {
+  StorageAdapter,
+  StoredCredential,
+  StoredSession,
+  CreateWalletResult,
+  ConnectWalletResult,
+  TransactionResult,
+  AssembledTransaction,
+  ExternalWalletAdapter,
+  SelectedSigner,
+  ContractSigner,
+  ContextRule,
+  ContextRuleType,
+} from "smart-account-kit";
+
+// ── Boundless SDK config ────────────────────────────────────────
+
+export interface BoundlessSdkConfig {
+  network: "mainnet" | "testnet";
+  rpcUrl?: string;
+  rpId: string;
+  rpName: string;
+  backendUrl: string;
+  relayerProxyUrl?: string;
+  storage?: import("smart-account-kit").StorageAdapter;
+}
+
+// ── connect / register results ──────────────────────────────────
+
+export interface ConnectOptions {
+  prompt?: boolean;
+}
+
+export interface ConnectResult {
+  walletAddress: string; // C… contract ID
+  credentialId: string;
+  isNew: boolean;
+}
+
+// ── signAndSubmit result ────────────────────────────────────────
+
+export interface SignAndSubmitResult {
+  hash: string;
+  success: boolean;
+}
+
+// ── recovery key ────────────────────────────────────────────────
+
+export interface AddRecoveryKeyOptions {
+  appName: string;
+  userName: string;
+  nickname?: string;
+}
+
+export interface RecoveryKeyResult {
+  credentialId: string;
+}
+
+// ── events ──────────────────────────────────────────────────────
+
+export type BoundlessEventName =
+  | "walletConnected"
+  | "walletDisconnected"
+  | "credentialCreated"
+  | "credentialDeleted"
+  | "sessionExpired"
+  | "transactionSigned"
+  | "transactionSubmitted";
+
+export type BoundlessEventHandler = (...args: unknown[]) => void;

package/src/utils.ts

@@ -0,0 +1,21 @@
+/**
+ * Validate that a string looks like a Soroban contract address.
+ * Soroban contract IDs start with 'C' and are 56 characters (StrKey).
+ */
+export function isValidContractAddress(addr: string): boolean {
+  return typeof addr === "string" && addr.length === 56 && addr.startsWith("C");
+}
+
+/**
+ * Validate that a string looks like a Stellar account address (G…).
+ */
+export function isValidStellarAddress(addr: string): boolean {
+  return typeof addr === "string" && addr.length === 56 && addr.startsWith("G");
+}
+
+/**
+ * Sleep for N milliseconds.  Useful in retry loops.
+ */
+export function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "noImplicitAny": true,
+    "strictNullChecks": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}