@opendatalabs/vana-sdk 0.1.0-alpha.dd95ac2 → 0.1.0-alpha.e2e45dd

package/dist/index.node.d.cts

@@ -634,8 +634,6 @@ interface ServerInfo {
  * @category Permissions
  */
 interface AddAndTrustServerParams {
-    /** Server owner address */
-    owner: Address;
     /** Server address */
     serverAddress: Address;
     /** Server URL */
@@ -670,8 +668,6 @@ interface UntrustServerParams {
 interface AddAndTrustServerInput {
     /** User nonce */
     nonce: bigint;
-    /** Server owner address */
-    owner: Address;
     /** Server address */
     serverAddress: Address;
     /** Server URL */
@@ -712,13 +708,13 @@ interface AddAndTrustServerTypedData {
     domain: PermissionGrantDomain;
     /** EIP-712 types */
     types: {
-        AddAndTrustServer: Array<{
+        AddServer: Array<{
             name: string;
             type: string;
         }>;
     };
     /** Primary type */
-    primaryType: "AddAndTrustServer";
+    primaryType: "AddServer";
     /** Message to sign */
     message: AddAndTrustServerInput;
 }
@@ -1143,6 +1139,22 @@ interface RelayerCallbacks {
      * @returns Promise resolving to the transaction hash
      */
     submitAddAndTrustServer?: (typedData: AddAndTrustServerTypedData, signature: Hash) => Promise<Hash>;
+    /**
+     * Submit a signed permission addition transaction for relay
+     *
+     * @param typedData - The EIP-712 typed data that was signed
+     * @param signature - The user's signature
+     * @returns Promise resolving to the transaction hash
+     */
+    submitAddPermission?: (typedData: GenericTypedData, signature: Hash) => Promise<Hash>;
+    /**
+     * Submit a signed server files and permissions transaction for relay
+     *
+     * @param typedData - The EIP-712 typed data that was signed
+     * @param signature - The user's signature
+     * @returns Promise resolving to the transaction hash
+     */
+    submitAddServerFilesAndPermissions?: (typedData: ServerFilesAndPermissionTypedData, signature: Hash) => Promise<Hash>;
     /**
      * Submit a file addition for relay
      *
@@ -30031,7 +30043,10 @@ declare class PermissionsController {
      */
     submitRevokeWithSignature(params: RevokePermissionParams): Promise<Hash>;
     /**
+     * @deprecated Use getPermissionsUserNonce() for permission operations or getServersUserNonce() for server operations
+     *
      * Retrieves the user's current nonce from the DataPortabilityServers contract.
+     * This method is deprecated in favor of more specific nonce methods.
      *
      * The nonce is used to prevent replay attacks in signed transactions and must
      * be incremented with each transaction to maintain security.
@@ -30043,8 +30058,12 @@ declare class PermissionsController {
      * @private
      * @example
      * ```typescript
+     * // Deprecated - use specific methods instead
      * const nonce = await this.getUserNonce();
-     * console.log(`Current nonce: ${nonce}`);
+     *
+     * // Use these instead:
+     * const permissionsNonce = await this.getPermissionsUserNonce();
+     * const serversNonce = await this.getServersUserNonce();
      * ```
      */
     private getUserNonce;
@@ -30052,16 +30071,32 @@ declare class PermissionsController {
      * Retrieves the user's current nonce from the DataPortabilityServers contract.
      * This nonce is used for server-related operations (AddAndTrustServer, TrustServer, UntrustServer).
      *
-     * @returns Promise resolving to the current nonce
+     * @returns Promise resolving to the current servers nonce
+     * @throws {NonceError} When reading nonce from contract fails
      * @private
      *
      * @example
      * ```typescript
-     * const nonce = await this.getServerNonce();
-     * console.log(`Current server nonce: ${nonce}`);
+     * const nonce = await this.getServersUserNonce();
+     * console.log(`Current servers nonce: ${nonce}`);
      * ```
      */
-    private getServerNonce;
+    private getServersUserNonce;
+    /**
+     * Retrieves the user's current nonce from the DataPortabilityPermissions contract.
+     * This nonce is used for permission-related operations (addPermission, addServerFilesAndPermissions).
+     *
+     * @returns Promise resolving to the current permissions nonce
+     * @throws {NonceError} When reading nonce from contract fails
+     * @private
+     *
+     * @example
+     * ```typescript
+     * const nonce = await this.getPermissionsUserNonce();
+     * console.log(`Current permissions nonce: ${nonce}`);
+     * ```
+     */
+    private getPermissionsUserNonce;
     /**
      * Composes the EIP-712 typed data for PermissionGrant (new simplified format).
      *
@@ -30760,19 +30795,51 @@ declare class PermissionsController {
      */
     getPermissions(permissionId: bigint): Promise<PermissionInfo>;
     /**
-     * Submit permission with signature to the blockchain
+     * Submit permission with signature to the blockchain (supports gasless transactions)
      *
      * @param params - Parameters for adding permission
      * @returns Promise resolving to transaction hash
+     * @throws {RelayerError} When gasless transaction submission fails
+     * @throws {SignatureError} When user rejects the signature request
+     * @throws {BlockchainError} When permission addition fails
+     * @throws {NetworkError} When network communication fails
      */
     submitAddPermission(params: ServerFilesAndPermissionParams): Promise<Hash>;
     /**
-     * Submit server files and permissions with signature to the blockchain
+     * Submits an already-signed add permission transaction to the blockchain.
+     * This method supports both relayer-based gasless transactions and direct transactions.
+     *
+     * @param typedData - The EIP-712 typed data for AddPermission
+     * @param signature - The user's signature
+     * @returns Promise resolving to the transaction hash
+     * @throws {RelayerError} When gasless transaction submission fails
+     * @throws {BlockchainError} When permission addition fails
+     * @throws {NetworkError} When network communication fails
+     */
+    submitSignedAddPermission(typedData: GenericTypedData, signature: Hash): Promise<Hash>;
+    /**
+     * Submit server files and permissions with signature to the blockchain (supports gasless transactions)
      *
      * @param params - Parameters for adding server files and permissions
      * @returns Promise resolving to transaction hash
+     * @throws {RelayerError} When gasless transaction submission fails
+     * @throws {SignatureError} When user rejects the signature request
+     * @throws {BlockchainError} When server files and permissions addition fails
+     * @throws {NetworkError} When network communication fails
      */
     submitAddServerFilesAndPermissions(params: ServerFilesAndPermissionParams): Promise<Hash>;
+    /**
+     * Submits an already-signed add server files and permissions transaction to the blockchain.
+     * This method supports both relayer-based gasless transactions and direct transactions.
+     *
+     * @param typedData - The EIP-712 typed data for AddServerFilesAndPermissions
+     * @param signature - The user's signature
+     * @returns Promise resolving to the transaction hash
+     * @throws {RelayerError} When gasless transaction submission fails
+     * @throws {BlockchainError} When server files and permissions addition fails
+     * @throws {NetworkError} When network communication fails
+     */
+    submitSignedAddServerFilesAndPermissions(typedData: ServerFilesAndPermissionTypedData, signature: Hash): Promise<Hash>;
     /**
      * Submit permission revocation with signature to the blockchain
      *
@@ -30780,6 +30847,22 @@ declare class PermissionsController {
      * @returns Promise resolving to transaction hash
      */
     submitRevokePermission(permissionId: bigint): Promise<Hash>;
+    /**
+     * Submits a signed add permission transaction directly to the blockchain.
+     *
+     * @param typedData - The typed data structure for the permission addition
+     * @param signature - The cryptographic signature authorizing the transaction
+     * @returns Promise resolving to the transaction hash
+     */
+    private submitDirectAddPermissionTransaction;
+    /**
+     * Submits a signed add server files and permissions transaction directly to the blockchain.
+     *
+     * @param typedData - The typed data structure for the server files and permissions addition
+     * @param signature - The cryptographic signature authorizing the transaction
+     * @returns Promise resolving to the transaction hash
+     */
+    private submitDirectAddServerFilesAndPermissionsTransaction;
 }
 
 /**
@@ -36388,6 +36471,9 @@ interface RelayerRequestPayload {
  * - PermissionRevoke: Permission revocations
  * - TrustServer: Trust server operations
  * - UntrustServer: Untrust server operations
+ * - AddServer: Add and trust server operations
+ * - RegisterGrantee: Register grantee operations
+ * - ServerFilesAndPermission: Batch operation for server, files, and permissions
  *
  * @param sdk - Initialized Vana SDK instance
  * @param payload - Request payload containing typed data, signature, and optional security check

package/dist/index.node.d.ts

@@ -634,8 +634,6 @@ interface ServerInfo {
  * @category Permissions
  */
 interface AddAndTrustServerParams {
-    /** Server owner address */
-    owner: Address;
     /** Server address */
     serverAddress: Address;
     /** Server URL */
@@ -670,8 +668,6 @@ interface UntrustServerParams {
 interface AddAndTrustServerInput {
     /** User nonce */
     nonce: bigint;
-    /** Server owner address */
-    owner: Address;
     /** Server address */
     serverAddress: Address;
     /** Server URL */
@@ -712,13 +708,13 @@ interface AddAndTrustServerTypedData {
     domain: PermissionGrantDomain;
     /** EIP-712 types */
     types: {
-        AddAndTrustServer: Array<{
+        AddServer: Array<{
             name: string;
             type: string;
         }>;
     };
     /** Primary type */
-    primaryType: "AddAndTrustServer";
+    primaryType: "AddServer";
     /** Message to sign */
     message: AddAndTrustServerInput;
 }
@@ -1143,6 +1139,22 @@ interface RelayerCallbacks {
      * @returns Promise resolving to the transaction hash
      */
     submitAddAndTrustServer?: (typedData: AddAndTrustServerTypedData, signature: Hash) => Promise<Hash>;
+    /**
+     * Submit a signed permission addition transaction for relay
+     *
+     * @param typedData - The EIP-712 typed data that was signed
+     * @param signature - The user's signature
+     * @returns Promise resolving to the transaction hash
+     */
+    submitAddPermission?: (typedData: GenericTypedData, signature: Hash) => Promise<Hash>;
+    /**
+     * Submit a signed server files and permissions transaction for relay
+     *
+     * @param typedData - The EIP-712 typed data that was signed
+     * @param signature - The user's signature
+     * @returns Promise resolving to the transaction hash
+     */
+    submitAddServerFilesAndPermissions?: (typedData: ServerFilesAndPermissionTypedData, signature: Hash) => Promise<Hash>;
     /**
      * Submit a file addition for relay
      *
@@ -30031,7 +30043,10 @@ declare class PermissionsController {
      */
     submitRevokeWithSignature(params: RevokePermissionParams): Promise<Hash>;
     /**
+     * @deprecated Use getPermissionsUserNonce() for permission operations or getServersUserNonce() for server operations
+     *
      * Retrieves the user's current nonce from the DataPortabilityServers contract.
+     * This method is deprecated in favor of more specific nonce methods.
      *
      * The nonce is used to prevent replay attacks in signed transactions and must
      * be incremented with each transaction to maintain security.
@@ -30043,8 +30058,12 @@ declare class PermissionsController {
      * @private
      * @example
      * ```typescript
+     * // Deprecated - use specific methods instead
      * const nonce = await this.getUserNonce();
-     * console.log(`Current nonce: ${nonce}`);
+     *
+     * // Use these instead:
+     * const permissionsNonce = await this.getPermissionsUserNonce();
+     * const serversNonce = await this.getServersUserNonce();
      * ```
      */
     private getUserNonce;
@@ -30052,16 +30071,32 @@ declare class PermissionsController {
      * Retrieves the user's current nonce from the DataPortabilityServers contract.
      * This nonce is used for server-related operations (AddAndTrustServer, TrustServer, UntrustServer).
      *
-     * @returns Promise resolving to the current nonce
+     * @returns Promise resolving to the current servers nonce
+     * @throws {NonceError} When reading nonce from contract fails
      * @private
      *
      * @example
      * ```typescript
-     * const nonce = await this.getServerNonce();
-     * console.log(`Current server nonce: ${nonce}`);
+     * const nonce = await this.getServersUserNonce();
+     * console.log(`Current servers nonce: ${nonce}`);
      * ```
      */
-    private getServerNonce;
+    private getServersUserNonce;
+    /**
+     * Retrieves the user's current nonce from the DataPortabilityPermissions contract.
+     * This nonce is used for permission-related operations (addPermission, addServerFilesAndPermissions).
+     *
+     * @returns Promise resolving to the current permissions nonce
+     * @throws {NonceError} When reading nonce from contract fails
+     * @private
+     *
+     * @example
+     * ```typescript
+     * const nonce = await this.getPermissionsUserNonce();
+     * console.log(`Current permissions nonce: ${nonce}`);
+     * ```
+     */
+    private getPermissionsUserNonce;
     /**
      * Composes the EIP-712 typed data for PermissionGrant (new simplified format).
      *
@@ -30760,19 +30795,51 @@ declare class PermissionsController {
      */
     getPermissions(permissionId: bigint): Promise<PermissionInfo>;
     /**
-     * Submit permission with signature to the blockchain
+     * Submit permission with signature to the blockchain (supports gasless transactions)
      *
      * @param params - Parameters for adding permission
      * @returns Promise resolving to transaction hash
+     * @throws {RelayerError} When gasless transaction submission fails
+     * @throws {SignatureError} When user rejects the signature request
+     * @throws {BlockchainError} When permission addition fails
+     * @throws {NetworkError} When network communication fails
      */
     submitAddPermission(params: ServerFilesAndPermissionParams): Promise<Hash>;
     /**
-     * Submit server files and permissions with signature to the blockchain
+     * Submits an already-signed add permission transaction to the blockchain.
+     * This method supports both relayer-based gasless transactions and direct transactions.
+     *
+     * @param typedData - The EIP-712 typed data for AddPermission
+     * @param signature - The user's signature
+     * @returns Promise resolving to the transaction hash
+     * @throws {RelayerError} When gasless transaction submission fails
+     * @throws {BlockchainError} When permission addition fails
+     * @throws {NetworkError} When network communication fails
+     */
+    submitSignedAddPermission(typedData: GenericTypedData, signature: Hash): Promise<Hash>;
+    /**
+     * Submit server files and permissions with signature to the blockchain (supports gasless transactions)
      *
      * @param params - Parameters for adding server files and permissions
      * @returns Promise resolving to transaction hash
+     * @throws {RelayerError} When gasless transaction submission fails
+     * @throws {SignatureError} When user rejects the signature request
+     * @throws {BlockchainError} When server files and permissions addition fails
+     * @throws {NetworkError} When network communication fails
      */
     submitAddServerFilesAndPermissions(params: ServerFilesAndPermissionParams): Promise<Hash>;
+    /**
+     * Submits an already-signed add server files and permissions transaction to the blockchain.
+     * This method supports both relayer-based gasless transactions and direct transactions.
+     *
+     * @param typedData - The EIP-712 typed data for AddServerFilesAndPermissions
+     * @param signature - The user's signature
+     * @returns Promise resolving to the transaction hash
+     * @throws {RelayerError} When gasless transaction submission fails
+     * @throws {BlockchainError} When server files and permissions addition fails
+     * @throws {NetworkError} When network communication fails
+     */
+    submitSignedAddServerFilesAndPermissions(typedData: ServerFilesAndPermissionTypedData, signature: Hash): Promise<Hash>;
     /**
      * Submit permission revocation with signature to the blockchain
      *
@@ -30780,6 +30847,22 @@ declare class PermissionsController {
      * @returns Promise resolving to transaction hash
      */
     submitRevokePermission(permissionId: bigint): Promise<Hash>;
+    /**
+     * Submits a signed add permission transaction directly to the blockchain.
+     *
+     * @param typedData - The typed data structure for the permission addition
+     * @param signature - The cryptographic signature authorizing the transaction
+     * @returns Promise resolving to the transaction hash
+     */
+    private submitDirectAddPermissionTransaction;
+    /**
+     * Submits a signed add server files and permissions transaction directly to the blockchain.
+     *
+     * @param typedData - The typed data structure for the server files and permissions addition
+     * @param signature - The cryptographic signature authorizing the transaction
+     * @returns Promise resolving to the transaction hash
+     */
+    private submitDirectAddServerFilesAndPermissionsTransaction;
 }
 
 /**
@@ -36388,6 +36471,9 @@ interface RelayerRequestPayload {
  * - PermissionRevoke: Permission revocations
  * - TrustServer: Trust server operations
  * - UntrustServer: Untrust server operations
+ * - AddServer: Add and trust server operations
+ * - RegisterGrantee: Register grantee operations
+ * - ServerFilesAndPermission: Batch operation for server, files, and permissions
  *
  * @param sdk - Initialized Vana SDK instance
  * @param payload - Request payload containing typed data, signature, and optional security check