@magicnewton/newton-protocol-sdk 0.5.3 → 0.5.4

package/dist/types/modules/avs/index.d.mts

@@ -1,82 +0,0 @@
-import { type SimulatePolicyDataParams, type SimulatePolicyDataResult, type SimulatePolicyDataWithClientParams, type SimulatePolicyDataWithClientResult, type SimulatePolicyParams, type SimulatePolicyResult, type SimulateTaskParams, type SimulateTaskResult, type SubmitEvaluationRequestParams, type SubmitIntentResult, type Task, type TaskId, type TaskResponseResult, TaskStatus } from '@core/types/task';
-import { type Address, type PublicClient as Client, type Hex, type WalletClient } from 'viem';
-export interface CreateTaskResult {
-    task_id: Hex;
-    task_request: unknown;
-    status: 'Completed' | 'Failed';
-    aggregation_response: unknown;
-    timestamp: number;
-    error?: unknown;
-}
-export interface PendingTaskBuilder {
-    readonly taskId?: TaskId;
-    waitForTaskResponded: ({ timeoutMs, }: {
-        timeoutMs?: number;
-    }) => Promise<TaskResponseResult>;
-}
-declare const waitForTaskResponded: (publicClient: Client, args: {
-    taskId?: Hex;
-    timeoutMs?: number;
-    abortSignal?: AbortSignal;
-}, taskManagerAddress: Address, taskRequestedAtBlock?: bigint) => Promise<TaskResponseResult>;
-declare const getTaskResponseHash: (publicClient: Client, args: {
-    taskId: TaskId;
-}, taskManagerAddress: Address) => Promise<Hex | null>;
-declare const getTaskStatus: (publicClient: Client, args: {
-    taskId: TaskId;
-}, taskManagerAddress: Address, attestationValidatorAddress: Address) => Promise<TaskStatus>;
-declare function submitEvaluationRequest(walletClient: WalletClient, args: SubmitEvaluationRequestParams, taskManagerAddress: Address, apiKey: string, gatewayApiUrlOverride?: string): Promise<{
-    result: {
-        taskId: Hex;
-        txHash: Hex;
-    };
-} & PendingTaskBuilder>;
-/**
- * Evaluate intent directly without waiting for task response confirmation on source chain.
- * Results are to be used with `validateAttestationDirect` on NewtonPolicyClient (NewtonProverTaskManagerShared)
- *
- * @param walletClient - Wallet client
- * @param args - Evaluation request parameters
- * @param apiKey - API key
- * @param gatewayApiUrlOverride - Gateway API URL override
- * @returns Evaluation result
- */
-declare function evaluateIntentDirect(walletClient: WalletClient, args: SubmitEvaluationRequestParams, apiKey: string, gatewayApiUrlOverride?: string): Promise<{
-    result: {
-        evaluationResult: boolean;
-        task: Task;
-        taskResponse: unknown;
-        blsSignature: unknown;
-    };
-}>;
-/**
- * Submit intent and subscribe to task response on source chain (this will be slower but can be used to challenge the task evaluation)
- * Results are to be used with `validateAttestation` on NewtonPolicyClient (NewtonProverTaskManager)
- *
- * @param walletClient - Wallet client
- * @param args
- * @param apiKey
- * @param gatewayApiUrlOverride
- * @returns
- */
-declare function submitIntentAndSubscribe(walletClient: WalletClient, args: SubmitEvaluationRequestParams, apiKey: string, gatewayApiUrlOverride?: string): Promise<{
-    result: SubmitIntentResult;
-    ws: WebSocket;
-}>;
-/**
- * Simulates task evaluation (newt_simulateTask). Forwards to an operator and returns allow/deny without executing on-chain.
- */
-declare function simulateTask(walletClient: WalletClient, args: SimulateTaskParams, apiKey: string, gatewayApiUrlOverride?: string): Promise<SimulateTaskResult>;
-/**
- * Simulates full Rego policy evaluation (newt_simulatePolicy). Tests policy with sample intent and policy data; may require ownership if PolicyData uses stored secrets.
- */
-declare function simulatePolicy(walletClient: WalletClient, args: SimulatePolicyParams, apiKey: string, gatewayApiUrlOverride?: string): Promise<SimulatePolicyResult>;
-/**
- * Simulates PolicyData WASM execution with caller-provided secrets (newt_simulatePolicyData). No ownership verification.
- */
-declare function simulatePolicyData(walletClient: WalletClient, args: SimulatePolicyDataParams, apiKey: string, gatewayApiUrlOverride?: string): Promise<SimulatePolicyDataResult>;
-/**
- * Simulates PolicyData WASM execution with stored secrets for a policy client (newt_simulatePolicyDataWithClient). Requires ownership.
- */
-declare function simulatePolicyDataWithClient(walletClient: WalletClient, args: SimulatePolicyDataWithClientParams, apiKey: string, gatewayApiUrlOverride?: string): Promise<SimulatePolicyDataWithClientResult>;
-export { submitEvaluationRequest, waitForTaskResponded, getTaskResponseHash, getTaskStatus, evaluateIntentDirect, submitIntentAndSubscribe, simulateTask, simulatePolicy, simulatePolicyData, simulatePolicyDataWithClient, };

package/dist/types/modules/policy/index.d.mts

@@ -1,228 +0,0 @@
-import type { PolicyId, PolicyParamsJson } from '@core/types/policy';
-import { type Address, type PublicClient, type WalletClient } from 'viem';
-export declare const policyWriteFunctions: {
-    initialize: ({ walletClient, policyContractAddress, ...args }: {
-        walletClient: WalletClient;
-        policyContractAddress: Address;
-        factory: Address;
-        entrypoint: string;
-        policyCid: string;
-        schemaCid: string;
-        policyData: Address[];
-        metadataCid: string;
-        owner: Address;
-    }) => Promise<`0x${string}`>;
-    renounceOwnership: ({ walletClient, policyContractAddress, }: {
-        walletClient: WalletClient;
-        policyContractAddress: Address;
-    }) => Promise<`0x${string}`>;
-    transferOwnership: ({ walletClient, policyContractAddress, ...args }: {
-        walletClient: WalletClient;
-        policyContractAddress: Address;
-        newOwner: Address;
-    }) => Promise<`0x${string}`>;
-};
-export declare const policyReadFunctions: {
-    getPolicyId: ({ publicClient, policyContractAddress, client, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-        client: Address;
-    }) => Promise<`0x${string}`>;
-    getPolicyConfig: ({ publicClient, policyContractAddress, policyId, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-        policyId: `0x${string}`;
-    }) => Promise<{
-        policyParams: string | object;
-        policyParamsHex: `0x${string}`;
-        expireAfter: number;
-    }>;
-    supportsInterface: ({ publicClient, policyContractAddress, interfaceId, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-        interfaceId: `0x${string}`;
-    }) => Promise<boolean>;
-    owner: ({ publicClient, policyContractAddress, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-    }) => Promise<Address>;
-    factory: ({ publicClient, policyContractAddress, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-    }) => Promise<Address>;
-    entrypoint: ({ publicClient, policyContractAddress, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-    }) => Promise<string>;
-    clientToPolicyId: ({ publicClient, policyContractAddress, client, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-        client: Address;
-    }) => Promise<`0x${string}`>;
-    policyData: ({ publicClient, policyContractAddress, index, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-        index: number;
-    }) => Promise<Address>;
-    getEntrypoint: ({ publicClient, policyContractAddress, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-    }) => Promise<string>;
-    getMetadataCid: ({ publicClient, policyContractAddress, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-    }) => Promise<string>;
-    getPolicyCid: ({ publicClient, policyContractAddress, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-    }) => Promise<string>;
-    getPolicyData: ({ publicClient, policyContractAddress, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-    }) => Promise<Address[]>;
-    getSchemaCid: ({ publicClient, policyContractAddress, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-    }) => Promise<string>;
-    isPolicyVerified: ({ publicClient, policyContractAddress, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-    }) => Promise<boolean>;
-    metadataCid: ({ publicClient, policyContractAddress, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-    }) => Promise<string>;
-    policyCid: ({ publicClient, policyContractAddress, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-    }) => Promise<string>;
-    schemaCid: ({ publicClient, policyContractAddress, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-    }) => Promise<string>;
-    precomputePolicyId: ({ publicClient, policyContractAddress, ...args }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-        policyContract: Address;
-        policyData: Address[];
-        params: PolicyParamsJson;
-        client: Address;
-        policyUri: string;
-        schemaUri: string;
-        entrypoint: string;
-        expireAfter?: number;
-        blockTimestamp?: bigint;
-    }) => PolicyId;
-};
-export declare const policyFunctions: {
-    initialize: ({ walletClient, policyContractAddress, ...args }: {
-        walletClient: WalletClient;
-        policyContractAddress: Address;
-        factory: Address;
-        entrypoint: string;
-        policyCid: string;
-        schemaCid: string;
-        policyData: Address[];
-        metadataCid: string;
-        owner: Address;
-    }) => Promise<`0x${string}`>;
-    renounceOwnership: ({ walletClient, policyContractAddress, }: {
-        walletClient: WalletClient;
-        policyContractAddress: Address;
-    }) => Promise<`0x${string}`>;
-    transferOwnership: ({ walletClient, policyContractAddress, ...args }: {
-        walletClient: WalletClient;
-        policyContractAddress: Address;
-        newOwner: Address;
-    }) => Promise<`0x${string}`>;
-    getPolicyId: ({ publicClient, policyContractAddress, client, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-        client: Address;
-    }) => Promise<`0x${string}`>;
-    getPolicyConfig: ({ publicClient, policyContractAddress, policyId, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-        policyId: `0x${string}`;
-    }) => Promise<{
-        policyParams: string | object;
-        policyParamsHex: `0x${string}`;
-        expireAfter: number;
-    }>;
-    supportsInterface: ({ publicClient, policyContractAddress, interfaceId, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-        interfaceId: `0x${string}`;
-    }) => Promise<boolean>;
-    owner: ({ publicClient, policyContractAddress, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-    }) => Promise<Address>;
-    factory: ({ publicClient, policyContractAddress, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-    }) => Promise<Address>;
-    entrypoint: ({ publicClient, policyContractAddress, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-    }) => Promise<string>;
-    clientToPolicyId: ({ publicClient, policyContractAddress, client, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-        client: Address;
-    }) => Promise<`0x${string}`>;
-    policyData: ({ publicClient, policyContractAddress, index, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-        index: number;
-    }) => Promise<Address>;
-    getEntrypoint: ({ publicClient, policyContractAddress, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-    }) => Promise<string>;
-    getMetadataCid: ({ publicClient, policyContractAddress, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-    }) => Promise<string>;
-    getPolicyCid: ({ publicClient, policyContractAddress, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-    }) => Promise<string>;
-    getPolicyData: ({ publicClient, policyContractAddress, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-    }) => Promise<Address[]>;
-    getSchemaCid: ({ publicClient, policyContractAddress, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-    }) => Promise<string>;
-    isPolicyVerified: ({ publicClient, policyContractAddress, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-    }) => Promise<boolean>;
-    metadataCid: ({ publicClient, policyContractAddress, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-    }) => Promise<string>;
-    policyCid: ({ publicClient, policyContractAddress, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-    }) => Promise<string>;
-    schemaCid: ({ publicClient, policyContractAddress, }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-    }) => Promise<string>;
-    precomputePolicyId: ({ publicClient, policyContractAddress, ...args }: {
-        publicClient: PublicClient;
-        policyContractAddress: Address;
-        policyContract: Address;
-        policyData: Address[];
-        params: PolicyParamsJson;
-        client: Address;
-        policyUri: string;
-        schemaUri: string;
-        entrypoint: string;
-        expireAfter?: number;
-        blockTimestamp?: bigint;
-    }) => PolicyId;
-};

package/dist/types/modules/privacy/index.d.mts

@@ -1,77 +0,0 @@
-/**
- * Newton Privacy Module — Client-side HPKE encryption for privacy-preserving policy evaluation.
- *
- * Encryption suite: X25519 KEM + HKDF-SHA256 + ChaCha20-Poly1305 (RFC 9180, Base mode).
- * Compatible with the Rust gateway's `crates/core/src/crypto/hpke.rs`.
- *
- * Key design constraints:
- * - Zero network calls during encrypt/createSecureEnvelope
- * - Offline capable once the gateway public key is known
- * - Ephemeral keys zeroed after encryption
- */
-import type { CreateSecureEnvelopeParams, Ed25519KeyPair, PrivacyAuthorizationResult, PrivacyPublicKeyResponse, SecureEnvelopeResult, SignPrivacyAuthorizationParams, StoreEncryptedSecretsParams, StoreEncryptedSecretsResponse, UploadEncryptedDataParams, UploadEncryptedDataResponse, UploadSecureEnvelopeParams } from '@core/types/privacy';
-/**
- * Create a SecureEnvelope by encrypting plaintext with HPKE.
- *
- * This is a pure, offline function — zero network calls.
- * The ephemeral HPKE key is generated internally and zeroed after use.
- *
- * The caller owns the signingKey buffer lifecycle. This function creates an
- * internal copy for signing and zeroes it immediately after use, but the
- * caller is responsible for zeroing the original Uint8Array when done.
- *
- * @param params - Encryption parameters
- * @param signingKey - Ed25519 private key seed (32 bytes as Uint8Array)
- * @returns Envelope + Ed25519 signature over the serialized envelope
- */
-export declare function createSecureEnvelope(params: CreateSecureEnvelopeParams, signingKey: Uint8Array): Promise<SecureEnvelopeResult>;
-/**
- * Fetch the gateway's X25519 HPKE public key.
- *
- * Clients call this once to discover which key to encrypt SecureEnvelopes to.
- * The result can be cached — the key only changes on gateway restart or key rotation.
- */
-export declare function getPrivacyPublicKey(chainId: number, apiKey: string, gatewayApiUrlOverride?: string): Promise<PrivacyPublicKeyResponse>;
-/**
- * Encrypt data and upload to the gateway in a single call.
- *
- * Combines createSecureEnvelope + RPC upload. If recipientPublicKey is not
- * provided, it is fetched from the gateway first via newt_getPrivacyPublicKey.
- */
-export declare function uploadEncryptedData(chainId: number, apiKey: string, params: UploadEncryptedDataParams, gatewayApiUrlOverride?: string): Promise<UploadEncryptedDataResponse>;
-/**
- * Upload a pre-built SecureEnvelope to the gateway.
- *
- * Use this when you've already created an envelope via createSecureEnvelope
- * and want to control the upload separately — e.g., offline-first apps that
- * encrypt now and upload later, or batching multiple envelopes.
- */
-export declare function uploadSecureEnvelope(chainId: number, apiKey: string, params: UploadSecureEnvelopeParams, gatewayApiUrlOverride?: string): Promise<UploadEncryptedDataResponse>;
-/**
- * Generate a random Ed25519 key pair for signing envelopes and privacy authorization.
- *
- * This is a pure offline function. The private key is generated from 32 bytes of
- * cryptographically secure randomness via `crypto.getRandomValues`.
- */
-export declare function generateSigningKeyPair(): Ed25519KeyPair;
-/**
- * Upload KMS-encrypted secrets for a policy client's PolicyData.
- *
- * The gateway decrypts via AWS KMS, validates against the PolicyData schema,
- * and stores the secrets for use during policy evaluation.
- */
-export declare function storeEncryptedSecrets(chainId: number, apiKey: string, params: StoreEncryptedSecretsParams, gatewayApiUrlOverride?: string): Promise<StoreEncryptedSecretsResponse>;
-/**
- * Compute dual Ed25519 signatures for privacy-enabled task creation.
- *
- * The gateway validates these signatures when `encrypted_data_refs` are present
- * in a `newt_createTask` request. This prevents unauthorized use of encrypted
- * data references across policy contexts.
- *
- * Signature scheme (must match `crates/gateway/src/processor/privacy_auth.rs`):
- * - User signs: keccak256(abi.encodePacked(policy_client, intent_hash, ref_id_1, ref_id_2, ...))
- * - App signs: keccak256(abi.encodePacked(policy_client, intent_hash, user_signature))
- *
- * This is a pure offline function — zero network calls.
- */
-export declare function signPrivacyAuthorization(params: SignPrivacyAuthorizationParams): PrivacyAuthorizationResult;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magicnewton/newton-protocol-sdk",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "description": "Official SDK for the Newton Protocol.",
   "author": "Newton Protocol <https://x.com/newton_xyz> (https://newton.xyz)",
   "private": false,