@accesly/react 1.3.2 → 1.4.1

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { Environment, CognitoConfig, AuthClient, SessionStorage, DeviceStore, TelemetrySink, TokenManager, AccesslyEndpoints, AuthStatus, CredentialRecord, EncryptedEnvelope, WalletHistoryItem } from '@accesly/core';
+import { Environment, CognitoConfig, AuthClient, SessionStorage, DeviceStore, TelemetrySink, TokenManager, AccesslyEndpoints, AuthStatus, CredentialRecord, TransferAsset, EncryptedEnvelope, WalletHistoryItem } from '@accesly/core';
 import * as react from 'react';
 import { ReactNode } from 'react';
 
@@ -389,8 +389,8 @@ interface FundTestnetResult {
     readonly reason?: 'mainnet-not-supported' | 'friendbot-error' | 'already-funded' | 'funded-now';
 }
 /**
- * Input para `tx.send(...)` — manda XLM desde el Smart Account del usuario a
- * cualquier address Stellar (G… clásico o C… contrato).
+ * Input para `tx.send(...)` — manda XLM o USDC desde el Smart Account del
+ * usuario a cualquier address Stellar (G… clásico o C… contrato).
  *
  * El SDK orquesta todo el flujo: simulate → ECDH F2 → reconstruct seed →
  * sign auth entry → submit. El caller solo entrega los inputs sensibles que
@@ -399,8 +399,18 @@ interface FundTestnetResult {
 interface SendXlmInput {
     /** Destinatario. G… (clásico) o C… (contrato). */
     readonly destinationAddress: string;
-    /** Monto en STROOPS (1 XLM = 10_000_000 stroops). Base-10 string para evitar precisión. */
+    /**
+     * Monto en unidades atómicas (1e-7 para ambos XLM y USDC). Base-10 string
+     * para evitar precisión. Ejemplo: `"12500000"` = 1.25 XLM o 1.25 USDC.
+     */
     readonly amountStroops: string;
+    /**
+     * Asset a transferir. Default `'XLM'` (backwards compat con apps <1.4 que
+     * no pasaban este field). Para USDC el Smart Account debe tener el rule 1
+     * (USDC_SAC tx_target) activado — si no, el backend devuelve 409 y la app
+     * debe disparar el flow "Activar USDC".
+     */
+    readonly asset?: TransferAsset;
     /**
      * F1 (Shamir share encoded incluyendo el byte de índice) ya en plano —
      * típicamente desencriptado client-side via WebAuthn PRF antes de llamar.
@@ -683,8 +693,8 @@ interface UseWalletStatusResult {
 declare function useWalletStatus(): UseWalletStatusResult;
 
 /**
- * `useBalance(walletAddress?)` — devuelve el balance XLM del Smart Account
- * con push real-time vía SSE.
+ * `useBalance(walletAddress?)` — devuelve los balances XLM y USDC del Smart
+ * Account con push real-time vía SSE.
  *
  * Si SSE está configurado (env tiene `walletStreamUrl` y `EventSource` existe),
  * el hook se suscribe al canal `balance` del `wallet-stream` Lambda y se
@@ -695,12 +705,20 @@ declare function useWalletStatus(): UseWalletStatusResult;
  *
  * El `walletAddress` se auto-resuelve desde el `DeviceStore` si no se pasa
  * (cubrir el caso "wallet del user actual sin tener que pasarla a mano").
+ *
+ * **Multi-asset (1.4.0+):** además de `stroops`/`xlm` (XLM) ahora devuelve
+ * `usdc` (formatted) y `usdcAtomic` (micro-USDC, 1e-7). Backwards compat:
+ * apps en 1.3 que solo leen `stroops`/`xlm` siguen funcionando sin cambios.
  */
 interface UseBalanceResult {
-    /** Stroops como string base-10. `null` mientras se carga o no hay address. */
+    /** XLM en stroops (string base-10). `null` mientras se carga o no hay address. */
     readonly stroops: string | null;
-    /** Mismo balance como string decimal en XLM. `null` mientras se carga. */
+    /** XLM formatted (sin trailing zeros). `null` mientras se carga. */
     readonly xlm: string | null;
+    /** USDC formatted (sin trailing zeros). `null` mientras se carga o si el SAC nunca registró la cuenta. */
+    readonly usdc: string | null;
+    /** USDC en unidades atómicas (1e-7 USDC). `null` mientras se carga. */
+    readonly usdcAtomic: string | null;
     readonly isLoading: boolean;
     readonly error: Error | null;
     /** Fuerza fetch HTTP inmediato (útil tras una operación del user). */

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Environment, CognitoConfig, AuthClient, SessionStorage, DeviceStore, TelemetrySink, TokenManager, AccesslyEndpoints, AuthStatus, CredentialRecord, EncryptedEnvelope, WalletHistoryItem } from '@accesly/core';
+import { Environment, CognitoConfig, AuthClient, SessionStorage, DeviceStore, TelemetrySink, TokenManager, AccesslyEndpoints, AuthStatus, CredentialRecord, TransferAsset, EncryptedEnvelope, WalletHistoryItem } from '@accesly/core';
 import * as react from 'react';
 import { ReactNode } from 'react';
 
@@ -389,8 +389,8 @@ interface FundTestnetResult {
     readonly reason?: 'mainnet-not-supported' | 'friendbot-error' | 'already-funded' | 'funded-now';
 }
 /**
- * Input para `tx.send(...)` — manda XLM desde el Smart Account del usuario a
- * cualquier address Stellar (G… clásico o C… contrato).
+ * Input para `tx.send(...)` — manda XLM o USDC desde el Smart Account del
+ * usuario a cualquier address Stellar (G… clásico o C… contrato).
  *
  * El SDK orquesta todo el flujo: simulate → ECDH F2 → reconstruct seed →
  * sign auth entry → submit. El caller solo entrega los inputs sensibles que
@@ -399,8 +399,18 @@ interface FundTestnetResult {
 interface SendXlmInput {
     /** Destinatario. G… (clásico) o C… (contrato). */
     readonly destinationAddress: string;
-    /** Monto en STROOPS (1 XLM = 10_000_000 stroops). Base-10 string para evitar precisión. */
+    /**
+     * Monto en unidades atómicas (1e-7 para ambos XLM y USDC). Base-10 string
+     * para evitar precisión. Ejemplo: `"12500000"` = 1.25 XLM o 1.25 USDC.
+     */
     readonly amountStroops: string;
+    /**
+     * Asset a transferir. Default `'XLM'` (backwards compat con apps <1.4 que
+     * no pasaban este field). Para USDC el Smart Account debe tener el rule 1
+     * (USDC_SAC tx_target) activado — si no, el backend devuelve 409 y la app
+     * debe disparar el flow "Activar USDC".
+     */
+    readonly asset?: TransferAsset;
     /**
      * F1 (Shamir share encoded incluyendo el byte de índice) ya en plano —
      * típicamente desencriptado client-side via WebAuthn PRF antes de llamar.
@@ -683,8 +693,8 @@ interface UseWalletStatusResult {
 declare function useWalletStatus(): UseWalletStatusResult;
 
 /**
- * `useBalance(walletAddress?)` — devuelve el balance XLM del Smart Account
- * con push real-time vía SSE.
+ * `useBalance(walletAddress?)` — devuelve los balances XLM y USDC del Smart
+ * Account con push real-time vía SSE.
  *
  * Si SSE está configurado (env tiene `walletStreamUrl` y `EventSource` existe),
  * el hook se suscribe al canal `balance` del `wallet-stream` Lambda y se
@@ -695,12 +705,20 @@ declare function useWalletStatus(): UseWalletStatusResult;
  *
  * El `walletAddress` se auto-resuelve desde el `DeviceStore` si no se pasa
  * (cubrir el caso "wallet del user actual sin tener que pasarla a mano").
+ *
+ * **Multi-asset (1.4.0+):** además de `stroops`/`xlm` (XLM) ahora devuelve
+ * `usdc` (formatted) y `usdcAtomic` (micro-USDC, 1e-7). Backwards compat:
+ * apps en 1.3 que solo leen `stroops`/`xlm` siguen funcionando sin cambios.
  */
 interface UseBalanceResult {
-    /** Stroops como string base-10. `null` mientras se carga o no hay address. */
+    /** XLM en stroops (string base-10). `null` mientras se carga o no hay address. */
     readonly stroops: string | null;
-    /** Mismo balance como string decimal en XLM. `null` mientras se carga. */
+    /** XLM formatted (sin trailing zeros). `null` mientras se carga. */
     readonly xlm: string | null;
+    /** USDC formatted (sin trailing zeros). `null` mientras se carga o si el SAC nunca registró la cuenta. */
+    readonly usdc: string | null;
+    /** USDC en unidades atómicas (1e-7 USDC). `null` mientras se carga. */
+    readonly usdcAtomic: string | null;
     readonly isLoading: boolean;
     readonly error: Error | null;
     /** Fuerza fetch HTTP inmediato (útil tras una operación del user). */

package/dist/index.js

@@ -665,6 +665,10 @@ function useAccesly() {
        * passkey + derivación HKDF + ensureWallet en una sola llamada.
        */
       async bootstrap(input) {
+        try {
+          await ctx.tokenManager.getValidIdToken();
+        } catch {
+        }
         const enc = new TextEncoder();
         const userIdHash = sha256(enc.encode(input.email));
         const prfSalt = getRandomBytes(32);
@@ -795,7 +799,8 @@ function useAccesly() {
         const explorerBase = networkPassphrase === "Public Global Stellar Network ; September 2015" ? "https://stellar.expert/explorer/public/tx/" : "https://stellar.expert/explorer/testnet/tx/";
         const sim = await ctx.endpoints.simulateTx({
           amountStroops: input.amountStroops,
-          destinationAddress: input.destinationAddress
+          destinationAddress: input.destinationAddress,
+          ...input.asset ? { asset: input.asset } : {}
         });
         const ephemeral = generateX25519Keypair();
         const ephemeralPubBase64 = base64FromBytes(ephemeral.publicKey);
@@ -836,7 +841,8 @@ function useAccesly() {
                 ledger: Math.floor(Date.now() / 1e3),
                 timestamp: (/* @__PURE__ */ new Date()).toISOString(),
                 to: input.destinationAddress,
-                amountStroops: input.amountStroops
+                amountStroops: input.amountStroops,
+                ...input.asset ? { asset: input.asset } : {}
               });
             }
           }
@@ -1491,6 +1497,8 @@ function useBalance(walletAddress) {
   );
   const [stroops, setStroops] = useState(null);
   const [xlm, setXlm] = useState(null);
+  const [usdc, setUsdc] = useState(null);
+  const [usdcAtomic, setUsdcAtomic] = useState(null);
   const [isLoading, setIsLoading] = useState(true);
   const [error, setError] = useState(null);
   const walletRef = useStableRef3(wallet);
@@ -1524,8 +1532,15 @@ function useBalance(walletAddress) {
     if (!resolvedAddress) return;
     try {
       const res = await endpointsRef.current.walletBalance(resolvedAddress);
-      setStroops(res.xlm.stroops);
-      setXlm(res.xlm.xlm);
+      setStroops(res.xlm.atomic ?? res.xlm.stroops);
+      setXlm(res.xlm.formatted ?? res.xlm.xlm);
+      if (res.usdc) {
+        setUsdc(res.usdc.formatted);
+        setUsdcAtomic(res.usdc.atomic);
+      } else {
+        setUsdc(null);
+        setUsdcAtomic(null);
+      }
       setError(null);
     } catch (err) {
       setError(err);
@@ -1544,8 +1559,22 @@ function useBalance(walletAddress) {
       resolvedAddress,
       "balance",
       (data) => {
-        setStroops(data.stroops);
-        setXlm(data.xlm);
+        const d = data;
+        const xlmField = d["xlm"];
+        if (xlmField && typeof xlmField === "object") {
+          const x = xlmField;
+          if (typeof x.atomic === "string") setStroops(x.atomic);
+          if (typeof x.formatted === "string") setXlm(x.formatted);
+        } else if (typeof xlmField === "string") {
+          setXlm(xlmField);
+        }
+        if (typeof d["stroops"] === "string") setStroops(d["stroops"]);
+        const usdcField = d["usdc"];
+        if (usdcField && typeof usdcField === "object") {
+          const u = usdcField;
+          if (typeof u.formatted === "string") setUsdc(u.formatted);
+          if (typeof u.atomic === "string") setUsdcAtomic(u.atomic);
+        }
         setError(null);
         setIsLoading(false);
       }
@@ -1576,7 +1605,7 @@ function useBalance(walletAddress) {
   const refresh = useCallback(async () => {
     await doFetchRef.current();
   }, [doFetchRef]);
-  return { stroops, xlm, isLoading, error, refresh };
+  return { stroops, xlm, usdc, usdcAtomic, isLoading, error, refresh };
 }
 
 // src/hooks/useWalletActivity.ts