@aeternity/aepp-sdk 11.0.1 → 12.0.0

package/es/tx/builder/index.d.ts

@@ -0,0 +1,75 @@
+import { EncodedData, EncodingType } from './../../utils/encoder';
+import { NestedUint8Array } from 'rlp';
+import { AE_AMOUNT_FORMATS } from '../../utils/amount-formatter';
+import { RawTxObject, TxField, TxTypeSchemas, TX_TYPE, TxSchema } from './schema';
+/**
+ * Validate transaction params
+ * @param params - Object with tx params
+ * @param schema - Transaction schema
+ * @param excludeKeys - Array of keys to exclude for validation
+ * @returns Object with validation errors
+ */
+export declare function validateParams(params: any, schema: TxField[], { excludeKeys }: {
+    excludeKeys: string[];
+}): object;
+/**
+ * Unpack binary transaction
+ * @param binary - Array with binary transaction field's
+ * @param schema - Transaction schema
+ * @returns Object with transaction field's
+ */
+export declare function unpackRawTx<Tx extends TxSchema>(binary: Uint8Array | NestedUint8Array, schema: TxField[]): RawTxObject<Tx>;
+export interface BuiltTx<Tx extends TxSchema, Prefix extends EncodingType> {
+    tx: EncodedData<Prefix>;
+    rlpEncoded: Uint8Array;
+    binary: Uint8Array;
+    txObject: RawTxObject<Tx>;
+}
+/**
+ * Build transaction hash
+ * @param _params - Object with tx params
+ * @param type - Transaction type
+ * @param options - options
+ * @param options.excludeKeys - Array of keys to exclude for validation and build
+ * @param options.denomination - Denomination of amounts
+ * @param options.prefix - Prefix of transaction
+ * @throws {@link InvalidTxParamsError}
+ * @returns object
+ * @returns object.tx Base64Check transaction hash with 'tx_' prefix
+ * @returns object.rlpEncoded rlp encoded transaction
+ * @returns object.binary binary transaction
+ */
+export declare function buildTx<TxType extends TX_TYPE, Prefix>(_params: Omit<TxTypeSchemas[TxType], 'tag' | 'VSN'> & {
+    VSN?: number;
+}, type: TxType, { excludeKeys, prefix, vsn, denomination }?: {
+    excludeKeys?: string[];
+    prefix?: EncodingType;
+    vsn?: number;
+    denomination?: AE_AMOUNT_FORMATS;
+}): BuiltTx<TxSchema, Prefix extends EncodingType ? Prefix : 'tx'>;
+export interface TxUnpacked<Tx extends TxSchema> {
+    txType: TX_TYPE;
+    tx: RawTxObject<Tx>;
+    rlpEncoded: Uint8Array;
+}
+/**
+ * Unpack transaction hash
+ * @param encodedTx - Transaction to unpack
+ * @param txType - Expected transaction type
+ * @returns object
+ * @returns object.tx Object with transaction param's
+ * @returns object.txType Transaction type
+ */
+export declare function unpackTx<TxType extends TX_TYPE>(encodedTx: EncodedData<'tx' | 'pi'>, txType?: TxType): TxUnpacked<TxTypeSchemas[TxType]>;
+/**
+ * Build a transaction hash
+ * @param rawTx - base64 or rlp encoded transaction
+ * @returns Transaction hash
+ */
+export declare function buildTxHash(rawTx: EncodedData<'tx'> | Uint8Array): EncodedData<'th'>;
+/**
+ * Build a contract public key by contractCreateTx or gaAttach
+ * @param contractTx - Transaction
+ * @returns Contract public key
+ */
+export declare function buildContractIdByContractTx(contractTx: EncodedData<'tx'>): EncodedData<'ct'>;