prividium 1.3.0 → 1.3.2

package/README.md

@@ -1,8 +1,10 @@
 # Prividium™ SDK & CLI
 
-A TypeScript SDK and CLI for integrating with the Prividium™ authorization system. The SDK provides popup OAuth, token
-management, and a viem transport for secure RPC; the CLI runs a local authenticated JSON-RPC proxy to your Prividium™
-RPC and manages basic configuration.
+A TypeScript SDK and CLI for integrating with the Prividium™ authorization system. The SDK handles **authentication** —
+signing in with OIDC or SIWE and attaching your identity to each request — while Prividium™ enforces **authorization**
+server-side from your assigned roles, controlling which contract functions, events, and data you can access; the SDK
+does not grant permissions. It provides popup OAuth, token management, and a viem transport for secure RPC; the CLI runs
+a local authenticated JSON-RPC proxy to your Prividium™ RPC and manages basic configuration.
 
 ## Features
 
@@ -417,6 +419,22 @@ interface PrividiumSiweConfig {
 browser-only), plus `address` (the wallet address derived from the account) and an `admin` namespace for permissions-API
 administration operations.
 
+### Fetching contract ABI: `prividium.fetchContractAbi(address)`
+
+Fetches the ABI and function metadata for a registered contract.
+
+```typescript
+const result = await prividium.fetchContractAbi('0xCONTRACT_ADDRESS');
+// result.abi — the contract ABI array
+// result.functions — list of { selector, signature, name, accessType }
+```
+
+**Parameters:**
+
+- `contractAddress: Address` — address of the contract to look up
+
+**Returns:** `Promise<ContractAbiResponse>` — includes `contractAddress`, `name`, `abi`, and `functions`.
+
 ### Admin API: `prividium.admin.*`
 
 The `admin` namespace on a `PrividiumSiweChain` instance wraps permissions-API endpoints that require admin

package/dist/sdk/siwe-chain.d.ts

@@ -1,6 +1,6 @@
 import { type Address, type Chain, type LocalAccount, type Transport } from 'viem';
 import { type AdminMethods } from './admin-api/index.js';
-import type { AuthorizeTransactionParams, AuthorizeTransactionResponse, Storage, TokenData, UserProfile } from './types.js';
+import type { AuthorizeTransactionParams, AuthorizeTransactionResponse, ContractAbiResponse, Storage, TokenData, UserProfile } from './types.js';
 export interface PrividiumSiweConfig {
     chain: Omit<Chain, 'rpcUrls'>;
     prividiumApiBaseUrl: string;
@@ -25,6 +25,7 @@ export interface PrividiumSiweChain {
     getWalletRpcUrl(): Promise<string>;
     invalidateWalletToken(): Promise<string>;
     authorizeTransaction(params: AuthorizeTransactionParams): Promise<AuthorizeTransactionResponse>;
+    fetchContractAbi(contractAddress: Address): Promise<ContractAbiResponse>;
     admin: AdminMethods;
 }
 export declare function createPrividiumSiweChain(config: PrividiumSiweConfig): PrividiumSiweChain;

package/dist/sdk/siwe-chain.js

@@ -173,6 +173,7 @@ export function createPrividiumSiweChain(config) {
         getWalletRpcUrl: apiMethods.getWalletRpcUrl,
         invalidateWalletToken: apiMethods.invalidateWalletToken,
         authorizeTransaction: apiMethods.authorizeTransaction,
+        fetchContractAbi: apiMethods.fetchContractAbi,
         admin
     };
 }