@withautonomi/autonomi 0.4.4 → 0.5.1

package/Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 edition = "2021"
 name = "autonomi-nodejs"
-version = "0.1.0"
+version = "0.1.1"
 description = "NodeJS bindings for the autonomi client"
 license = "GPL-3.0"
 
@@ -9,7 +9,7 @@ license = "GPL-3.0"
 crate-type = ["cdylib"]
 
 [dependencies]
-autonomi = { path = "../autonomi", version = "0.4.4" }
+autonomi = { path = "../autonomi", version = "0.5.1" }
 bytes = { version = "1.0.1", features = ["serde"] }
 eyre = "0.6.12"
 futures = "0.3"

package/index.d.ts

@@ -24,6 +24,8 @@ export declare class Client {
    * See `init_with_config`.
    */
   static initLocal(): Promise<Client>
+  /** Initialize a client that is configured to be connected to the alpha network. */
+  static initAlpha(): Promise<Client>
   /**
    * Initialize a client that bootstraps from a list of peers.
    *
@@ -199,7 +201,7 @@ export declare class Client {
    */
   vaultCost(owner: VaultSecretKey, maxSize: bigint): Promise<string>
   /**
-   * Put data into the client’s VaultPacket
+   * Put data into the client's VaultPacket
    *
    * Dynamically expand the vault capacity by paying for more space (Scratchpad) when needed.
    *
@@ -218,7 +220,7 @@ export declare class Client {
   /**
    * Create a new register key from a SecretKey and a name.
    *
-   * This derives a new SecretKey from the owner’s SecretKey using the name. Note that you will need to keep track of the names you used to create the register key.
+   * This derives a new SecretKey from the owner's SecretKey using the name. Note that you will need to keep track of the names you used to create the register key.
    */
   static registerKeyFromName(owner: SecretKey, name: string): SecretKey
   /** Create a new RegisterValue from bytes, make sure the bytes are not longer than REGISTER_VALUE_SIZE */
@@ -236,7 +238,7 @@ export declare class Client {
   registerUpdate(owner: SecretKey, newValue: Uint8Array, paymentOption: PaymentOption): Promise<string>
   /** Get the current value of the register */
   registerGet(addr: RegisterAddress): Promise<Uint8Array>
-  /** Get the cost of a register operation. Returns the cost of creation if it doesn’t exist, else returns the cost of an update */
+  /** Get the cost of a register operation. Returns the cost of creation if it doesn't exist, else returns the cost of an update */
   registerCost(owner: PublicKey): Promise<string>
 }
 export declare class ChunkPut {
@@ -386,6 +388,19 @@ export declare class Wallet {
   balance(): Promise<string>
   /** Returns the current balance of gas tokens in the wallet */
   balanceOfGas(): Promise<string>
+  /** Sets the transaction configuration for the wallet. */
+  setTransactionConfig(config: TransactionConfig): void
+}
+/** Transaction configuration for wallets */
+export declare class TransactionConfig {
+  /** Use the current market price for fee per gas. WARNING: This can result in unexpected high gas fees! */
+  static auto(): TransactionConfig
+  /** Use the current market price for fee per gas, but with an upper limit. */
+  static limitedAuto(limit: bigint): TransactionConfig
+  /** Use no max fee per gas. WARNING: This can result in unexpected high gas fees! */
+  static unlimited(): TransactionConfig
+  /** Use a custom max fee per gas in WEI. */
+  static custom(fee: bigint): TransactionConfig
 }
 /** Options for making payments on the network */
 export declare class PaymentOption {
@@ -450,7 +465,7 @@ export declare class Pointer {
    * This pointer would be stored on the network at the provided key's public key.
    * There can only be one pointer at a time at the same address (one per key).
    */
-  constructor(owner: SecretKey, counter: number, target: PointerTarget)
+  constructor(owner: SecretKey, counter: bigint, target: PointerTarget)
   /** Get the address of the pointer */
   address(): PointerAddress
   /** Get the owner of the pointer */
@@ -465,7 +480,7 @@ export declare class Pointer {
    * Get the counter of the pointer, the higher the counter, the more recent the pointer is
    * Similarly to counter CRDTs only the latest version (highest counter) of the pointer is kept on the network
    */
-  counter(): number
+  counter(): bigint
   /** Verifies if the pointer has a valid signature */
   verifySignature(): boolean
   /** Size of the pointer */

package/index.js

@@ -310,7 +310,7 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { Client, ChunkPut, GraphEntryPut, ScratchpadPut, PointerPut, DataPutResult, DataPutPublicResult, ArchivePutResult, ArchivePutPublicResult, DirContentUpload, DirUpload, FileContentUpload, DirContentUploadPublic, DirUploadPublic, FileContentUploadPublic, FetchAndDecryptVault, RegisterCreate, GraphEntryDescendant, XorName, ChunkAddress, GraphEntryAddress, DataAddress, ArchiveAddress, Wallet, PaymentOption, Network, PublicKey, SecretKey, GraphEntry, Pointer, PointerTarget, PointerAddress, Scratchpad, ScratchpadAddress, DataMapChunk, PrivateArchiveDataMap, PrivateArchive, VaultSecretKey, UserData, VaultContentType, Metadata, RegisterAddress, RegisterHistory, PublicArchive } = nativeBinding
+const { Client, ChunkPut, GraphEntryPut, ScratchpadPut, PointerPut, DataPutResult, DataPutPublicResult, ArchivePutResult, ArchivePutPublicResult, DirContentUpload, DirUpload, FileContentUpload, DirContentUploadPublic, DirUploadPublic, FileContentUploadPublic, FetchAndDecryptVault, RegisterCreate, GraphEntryDescendant, XorName, ChunkAddress, GraphEntryAddress, DataAddress, ArchiveAddress, Wallet, TransactionConfig, PaymentOption, Network, PublicKey, SecretKey, GraphEntry, Pointer, PointerTarget, PointerAddress, Scratchpad, ScratchpadAddress, DataMapChunk, PrivateArchiveDataMap, PrivateArchive, VaultSecretKey, UserData, VaultContentType, Metadata, RegisterAddress, RegisterHistory, PublicArchive } = nativeBinding
 
 module.exports.Client = Client
 module.exports.ChunkPut = ChunkPut
@@ -336,6 +336,7 @@ module.exports.GraphEntryAddress = GraphEntryAddress
 module.exports.DataAddress = DataAddress
 module.exports.ArchiveAddress = ArchiveAddress
 module.exports.Wallet = Wallet
+module.exports.TransactionConfig = TransactionConfig
 module.exports.PaymentOption = PaymentOption
 module.exports.Network = Network
 module.exports.PublicKey = PublicKey

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@withautonomi/autonomi",
-  "version": "0.4.4",
+  "version": "0.5.1",
   "description": "NodeJS bindings for Autonomi client",
   "main": "index.js",
   "types": "index.d.ts",
@@ -57,9 +57,9 @@
     "includeVersion": true
   },
   "optionalDependencies": {
-    "@withautonomi/autonomi-win32-x64-msvc": "0.4.4",
-    "@withautonomi/autonomi-darwin-x64": "0.4.4",
-    "@withautonomi/autonomi-linux-x64-gnu": "0.4.4",
-    "@withautonomi/autonomi-darwin-arm64": "0.4.4"
+    "@withautonomi/autonomi-win32-x64-msvc": "0.5.1",
+    "@withautonomi/autonomi-darwin-x64": "0.5.1",
+    "@withautonomi/autonomi-linux-x64-gnu": "0.5.1",
+    "@withautonomi/autonomi-darwin-arm64": "0.5.1"
   }
 }

package/src/lib.rs

@@ -72,6 +72,14 @@ impl Client {
         Ok(Self(client))
     }
 
+    /// Initialize a client that is configured to be connected to the alpha network.
+    #[napi(factory)]
+    pub async fn init_alpha() -> Result<Self> {
+        let client = autonomi::Client::init_alpha().await.map_err(map_error)?;
+
+        Ok(Self(client))
+    }
+
     /// Initialize a client that bootstraps from a list of peers.
     ///
     /// If any of the provided peers is a global address, the client will not be local.
@@ -143,12 +151,6 @@ impl Client {
         Ok(cost.to_string())
     }
 
-    // /// Upload chunks and retry failed uploads up to RETRY_ATTEMPTS times.
-    // #[napi]
-    // pub async fn upload_chunks_with_retries(&self, chunks: Vec<Chunk>, receipt: &Receipt) -> Vec<(Chunk, PutError)> {
-    //     todo!()
-    // }
-
     // Graph entries
 
     /// Fetches a GraphEntry from the network.
@@ -168,7 +170,7 @@ impl Client {
     pub async fn graph_entry_check_existance(&self, address: &GraphEntryAddress) -> Result<bool> {
         let exists = self
             .0
-            .graph_entry_check_existance(&address.0)
+            .graph_entry_check_existence(&address.0)
             .await
             .map_err(map_error)?;
 
@@ -217,7 +219,7 @@ impl Client {
     #[napi]
     pub async fn pointer_check_existance(&self, address: &PointerAddress) -> Result<bool> {
         self.0
-            .pointer_check_existance(&address.0)
+            .pointer_check_existence(&address.0)
             .await
             .map_err(map_error)
     }
@@ -314,7 +316,7 @@ impl Client {
     #[napi]
     pub async fn scratchpad_check_existance(&self, address: &ScratchpadAddress) -> Result<bool> {
         self.0
-            .scratchpad_check_existance(&address.0)
+            .scratchpad_check_existence(&address.0)
             .await
             .map_err(map_error)
     }
@@ -791,7 +793,7 @@ impl Client {
         Ok(cost.to_string())
     }
 
-    /// Put data into the client’s VaultPacket
+    /// Put data into the client's VaultPacket
     ///
     /// Dynamically expand the vault capacity by paying for more space (Scratchpad) when needed.
     ///
@@ -836,7 +838,7 @@ impl Client {
 
     /// Create a new register key from a SecretKey and a name.
     ///
-    /// This derives a new SecretKey from the owner’s SecretKey using the name. Note that you will need to keep track of the names you used to create the register key.
+    /// This derives a new SecretKey from the owner's SecretKey using the name. Note that you will need to keep track of the names you used to create the register key.
     #[napi]
     pub fn register_key_from_name(owner: &SecretKey, name: String) -> SecretKey {
         let key = autonomi::Client::register_key_from_name(&owner.0, &name);
@@ -903,7 +905,7 @@ impl Client {
             .map_err(map_error)
     }
 
-    /// Get the cost of a register operation. Returns the cost of creation if it doesn’t exist, else returns the cost of an update
+    /// Get the cost of a register operation. Returns the cost of creation if it doesn't exist, else returns the cost of an update
     #[napi]
     pub async fn register_cost(&self, owner: &PublicKey) -> Result</* AttoTokens */ String> {
         let cost = self
@@ -1449,6 +1451,67 @@ impl Wallet {
 
         Ok(balance.to_string())
     }
+
+    /// Sets the transaction configuration for the wallet.
+    #[napi]
+    pub fn set_transaction_config(&mut self, config: &TransactionConfig) {
+        self.0.set_transaction_config(config.0.clone())
+    }
+}
+
+/// Transaction configuration for wallets
+#[napi]
+pub struct TransactionConfig(autonomi::TransactionConfig);
+
+#[napi]
+impl TransactionConfig {
+    /// Use the current market price for fee per gas. WARNING: This can result in unexpected high gas fees!
+    #[napi(factory)]
+    pub fn auto() -> Self {
+        Self(autonomi::TransactionConfig {
+            max_fee_per_gas: autonomi::MaxFeePerGas::Auto,
+        })
+    }
+
+    /// Use the current market price for fee per gas, but with an upper limit.
+    #[napi(factory)]
+    pub fn limited_auto(limit: BigInt) -> Result<Self> {
+        let (_signed, value, lossless) = limit.get_u128();
+        if !lossless {
+            return Err(napi::Error::new(
+                Status::InvalidArg,
+                "expected limit to fit in a u128",
+            ));
+        }
+
+        Ok(Self(autonomi::TransactionConfig {
+            max_fee_per_gas: autonomi::MaxFeePerGas::LimitedAuto(value),
+        }))
+    }
+
+    /// Use no max fee per gas. WARNING: This can result in unexpected high gas fees!
+    #[napi(factory)]
+    pub fn unlimited() -> Self {
+        Self(autonomi::TransactionConfig {
+            max_fee_per_gas: autonomi::MaxFeePerGas::Unlimited,
+        })
+    }
+
+    /// Use a custom max fee per gas in WEI.
+    #[napi(factory)]
+    pub fn custom(fee: BigInt) -> Result<Self> {
+        let (_signed, value, lossless) = fee.get_u128();
+        if !lossless {
+            return Err(napi::Error::new(
+                Status::InvalidArg,
+                "expected fee to fit in a u128",
+            ));
+        }
+
+        Ok(Self(autonomi::TransactionConfig {
+            max_fee_per_gas: autonomi::MaxFeePerGas::Custom(value),
+        }))
+    }
 }
 
 /// Options for making payments on the network
@@ -1702,8 +1765,13 @@ impl Pointer {
     /// This pointer would be stored on the network at the provided key's public key.
     /// There can only be one pointer at a time at the same address (one per key).
     #[napi(constructor)]
-    pub fn new(owner: &SecretKey, counter: u32, target: &PointerTarget) -> Self {
-        Pointer(autonomi::Pointer::new(&owner.0, counter, target.0.clone()))
+    pub fn new(owner: &SecretKey, counter: BigInt, target: &PointerTarget) -> Result<Self> {
+        let counter = big_int_to_u64(counter, "counter")?;
+        Ok(Pointer(autonomi::Pointer::new(
+            &owner.0,
+            counter,
+            target.0.clone(),
+        )))
     }
 
     /// Get the address of the pointer
@@ -1739,7 +1807,7 @@ impl Pointer {
     /// Get the counter of the pointer, the higher the counter, the more recent the pointer is
     /// Similarly to counter CRDTs only the latest version (highest counter) of the pointer is kept on the network
     #[napi]
-    pub fn counter(&self) -> u32 {
+    pub fn counter(&self) -> u64 {
         self.0.counter()
     }