@openzeppelin/ui-renderer 1.1.1 → 1.2.0

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { AddressBookWidgetProps, ContractAdapter, ContractFunction, ContractSchema, ExecutionConfig, FieldTransforms, FieldType, FormFieldType, FormValues, FullContractAdapter, NetworkConfig, TransactionFormProps } from "@openzeppelin/ui-types";
+import { AddressBookWidgetProps, ContractAdapter, ContractFunction, ContractSchema, Ecosystem, ExecutionConfig, FieldTransforms, FieldType, FormFieldType, FormValues, FullContractAdapter, NetworkConfig, TransactionFormProps, TransactionSuccessPayload } from "@openzeppelin/ui-types";
 import React$1, { JSX } from "react";
 import { Control } from "react-hook-form";
 import { ButtonProps } from "@openzeppelin/ui-components";
@@ -65,7 +65,8 @@ declare function TransactionForm({
   contractSchema,
   adapter,
   isWalletConnected,
-  executionConfig
+  executionConfig,
+  onTransactionSuccess
 }: TransactionFormProps): React.ReactElement;
 //#endregion
 //#region src/utils/formUtils.d.ts
@@ -170,6 +171,32 @@ declare function createObjectTransform(): FieldTransforms<Record<string, unknown
  */
 declare function createArrayObjectTransform(): FieldTransforms<Record<string, unknown>[]>;
 //#endregion
+//#region src/utils/transactionSuccessCallback.d.ts
+/**
+ * Normalizes adapter `txHash` for the success callback (non-empty trimmed string or omitted).
+ * Expects the `txHash` string from `signAndBroadcast`, not arbitrary values (avoids coercing objects).
+ */
+declare function normalizeTransactionSuccessHash(finalTxHash: string | null | undefined): string | undefined;
+/**
+ * Builds the {@link TransactionSuccessPayload} passed to `onTransactionSuccess`.
+ */
+declare function buildTransactionSuccessPayload(options: {
+  networkId: TransactionSuccessPayload['network_id'];
+  ecosystem: Ecosystem;
+  executionMethod: ExecutionConfig['method'];
+  /** From `signAndBroadcast` result (`txHash: string`) */
+  finalTxHash: string | null | undefined;
+}): TransactionSuccessPayload;
+/** Minimal logger surface used by {@link invokeOnTransactionSuccess}. */
+type TransactionSuccessLog = {
+  error(component: string, message: string, error?: unknown): void;
+};
+/**
+ * Invokes `onTransactionSuccess` with error containment: synchronous throws and async
+ * rejections are logged and never rethrown, so host callbacks cannot break transaction flow.
+ */
+declare function invokeOnTransactionSuccess(callback: ((payload: TransactionSuccessPayload) => void | Promise<void>) | undefined, payload: TransactionSuccessPayload, log: TransactionSuccessLog): void;
+//#endregion
 //#region src/components/DynamicFormField.d.ts
 /**
  * Props for the DynamicFormField component
@@ -419,5 +446,5 @@ declare const NetworkSettingsDialog: React$1.FC<Props>;
  */
 declare const WalletConnectionWithSettings: React$1.FC;
 //#endregion
-export { AddressBookWidget, type AliasEditLookupResult, AliasEditPopover, type AliasEditPopoverProps, ContractActionBar, ContractStateWidget, DynamicFormField, ExecutionConfigDisplay, NetworkSettingsDialog, ParameterConstraints, type RendererConfig, TransactionExecuteButton, TransactionForm, type UseAliasEditStateReturn, WalletConnectionWithSettings, createAddressTransform, createArrayObjectTransform, createArrayTransform, createBigIntTransform, createBooleanTransform, createComplexTypeTransform, createDefaultFormValues, createNumberTransform, createObjectTransform, createTextTransform, createTransformForFieldType, generateDefaultValue, getDefaultValueByFieldType, rendererConfig, useAliasEditState, validateField };
+export { AddressBookWidget, type AliasEditLookupResult, AliasEditPopover, type AliasEditPopoverProps, ContractActionBar, ContractStateWidget, DynamicFormField, ExecutionConfigDisplay, NetworkSettingsDialog, ParameterConstraints, type RendererConfig, TransactionExecuteButton, TransactionForm, TransactionSuccessLog, type UseAliasEditStateReturn, WalletConnectionWithSettings, buildTransactionSuccessPayload, createAddressTransform, createArrayObjectTransform, createArrayTransform, createBigIntTransform, createBooleanTransform, createComplexTypeTransform, createDefaultFormValues, createNumberTransform, createObjectTransform, createTextTransform, createTransformForFieldType, generateDefaultValue, getDefaultValueByFieldType, invokeOnTransactionSuccess, normalizeTransactionSuccessHash, rendererConfig, useAliasEditState, validateField };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types/RendererConfig.ts","../src/config.ts","../src/components/TransactionForm.tsx","../src/utils/formUtils.ts","../src/components/DynamicFormField.tsx","../src/components/transaction/TransactionExecuteButton.tsx","../src/components/AddressBookWidget/AddressBookWidget.tsx","../src/components/AddressBookWidget/AliasEditPopover.tsx","../src/components/AddressBookWidget/useAliasEditState.ts","../src/components/ContractStateWidget/ContractStateWidget.tsx","../src/components/ContractActionBar/ContractActionBar.tsx","../src/components/ExecutionConfigDisplay/ExecutionConfigDisplay.tsx","../src/components/network/NetworkSettingsDialog.tsx","../src/components/WalletConnectionWithSettings.tsx"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types/RendererConfig.ts","../src/config.ts","../src/components/TransactionForm.tsx","../src/utils/formUtils.ts","../src/utils/transactionSuccessCallback.ts","../src/components/DynamicFormField.tsx","../src/components/transaction/TransactionExecuteButton.tsx","../src/components/AddressBookWidget/AddressBookWidget.tsx","../src/components/AddressBookWidget/AliasEditPopover.tsx","../src/components/AddressBookWidget/useAliasEditState.ts","../src/components/ContractStateWidget/ContractStateWidget.tsx","../src/components/ContractActionBar/ContractActionBar.tsx","../src/components/ExecutionConfigDisplay/ExecutionConfigDisplay.tsx","../src/components/network/NetworkSettingsDialog.tsx","../src/components/WalletConnectionWithSettings.tsx"],"sourcesContent":[],"mappings":"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"}

package/dist/index.d.mts

@@ -2,7 +2,7 @@ import React$1, { JSX } from "react";
 import { Control } from "react-hook-form";
 import { ButtonProps } from "@openzeppelin/ui-components";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
-import { AddressBookWidgetProps, ContractAdapter, ContractFunction, ContractSchema, ExecutionConfig, FieldTransforms, FieldType, FormFieldType, FormValues, FullContractAdapter, NetworkConfig, TransactionFormProps } from "@openzeppelin/ui-types";
+import { AddressBookWidgetProps, ContractAdapter, ContractFunction, ContractSchema, Ecosystem, ExecutionConfig, FieldTransforms, FieldType, FormFieldType, FormValues, FullContractAdapter, NetworkConfig, TransactionFormProps, TransactionSuccessPayload } from "@openzeppelin/ui-types";
 
 //#region src/types/RendererConfig.d.ts
 
@@ -65,7 +65,8 @@ declare function TransactionForm({
   contractSchema,
   adapter,
   isWalletConnected,
-  executionConfig
+  executionConfig,
+  onTransactionSuccess
 }: TransactionFormProps): React.ReactElement;
 //#endregion
 //#region src/utils/formUtils.d.ts
@@ -170,6 +171,32 @@ declare function createObjectTransform(): FieldTransforms<Record<string, unknown
  */
 declare function createArrayObjectTransform(): FieldTransforms<Record<string, unknown>[]>;
 //#endregion
+//#region src/utils/transactionSuccessCallback.d.ts
+/**
+ * Normalizes adapter `txHash` for the success callback (non-empty trimmed string or omitted).
+ * Expects the `txHash` string from `signAndBroadcast`, not arbitrary values (avoids coercing objects).
+ */
+declare function normalizeTransactionSuccessHash(finalTxHash: string | null | undefined): string | undefined;
+/**
+ * Builds the {@link TransactionSuccessPayload} passed to `onTransactionSuccess`.
+ */
+declare function buildTransactionSuccessPayload(options: {
+  networkId: TransactionSuccessPayload['network_id'];
+  ecosystem: Ecosystem;
+  executionMethod: ExecutionConfig['method'];
+  /** From `signAndBroadcast` result (`txHash: string`) */
+  finalTxHash: string | null | undefined;
+}): TransactionSuccessPayload;
+/** Minimal logger surface used by {@link invokeOnTransactionSuccess}. */
+type TransactionSuccessLog = {
+  error(component: string, message: string, error?: unknown): void;
+};
+/**
+ * Invokes `onTransactionSuccess` with error containment: synchronous throws and async
+ * rejections are logged and never rethrown, so host callbacks cannot break transaction flow.
+ */
+declare function invokeOnTransactionSuccess(callback: ((payload: TransactionSuccessPayload) => void | Promise<void>) | undefined, payload: TransactionSuccessPayload, log: TransactionSuccessLog): void;
+//#endregion
 //#region src/components/DynamicFormField.d.ts
 /**
  * Props for the DynamicFormField component
@@ -419,5 +446,5 @@ declare const NetworkSettingsDialog: React$1.FC<Props>;
  */
 declare const WalletConnectionWithSettings: React$1.FC;
 //#endregion
-export { AddressBookWidget, type AliasEditLookupResult, AliasEditPopover, type AliasEditPopoverProps, ContractActionBar, ContractStateWidget, DynamicFormField, ExecutionConfigDisplay, NetworkSettingsDialog, ParameterConstraints, type RendererConfig, TransactionExecuteButton, TransactionForm, type UseAliasEditStateReturn, WalletConnectionWithSettings, createAddressTransform, createArrayObjectTransform, createArrayTransform, createBigIntTransform, createBooleanTransform, createComplexTypeTransform, createDefaultFormValues, createNumberTransform, createObjectTransform, createTextTransform, createTransformForFieldType, generateDefaultValue, getDefaultValueByFieldType, rendererConfig, useAliasEditState, validateField };
+export { AddressBookWidget, type AliasEditLookupResult, AliasEditPopover, type AliasEditPopoverProps, ContractActionBar, ContractStateWidget, DynamicFormField, ExecutionConfigDisplay, NetworkSettingsDialog, ParameterConstraints, type RendererConfig, TransactionExecuteButton, TransactionForm, TransactionSuccessLog, type UseAliasEditStateReturn, WalletConnectionWithSettings, buildTransactionSuccessPayload, createAddressTransform, createArrayObjectTransform, createArrayTransform, createBigIntTransform, createBooleanTransform, createComplexTypeTransform, createDefaultFormValues, createNumberTransform, createObjectTransform, createTextTransform, createTransformForFieldType, generateDefaultValue, getDefaultValueByFieldType, invokeOnTransactionSuccess, normalizeTransactionSuccessHash, rendererConfig, useAliasEditState, validateField };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/RendererConfig.ts","../src/config.ts","../src/components/TransactionForm.tsx","../src/utils/formUtils.ts","../src/components/DynamicFormField.tsx","../src/components/transaction/TransactionExecuteButton.tsx","../src/components/AddressBookWidget/AddressBookWidget.tsx","../src/components/AddressBookWidget/AliasEditPopover.tsx","../src/components/AddressBookWidget/useAliasEditState.ts","../src/components/ContractStateWidget/ContractStateWidget.tsx","../src/components/ContractActionBar/ContractActionBar.tsx","../src/components/ExecutionConfigDisplay/ExecutionConfigDisplay.tsx","../src/components/network/NetworkSettingsDialog.tsx","../src/components/WalletConnectionWithSettings.tsx"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/RendererConfig.ts","../src/config.ts","../src/components/TransactionForm.tsx","../src/utils/formUtils.ts","../src/utils/transactionSuccessCallback.ts","../src/components/DynamicFormField.tsx","../src/components/transaction/TransactionExecuteButton.tsx","../src/components/AddressBookWidget/AddressBookWidget.tsx","../src/components/AddressBookWidget/AliasEditPopover.tsx","../src/components/AddressBookWidget/useAliasEditState.ts","../src/components/ContractStateWidget/ContractStateWidget.tsx","../src/components/ContractActionBar/ContractActionBar.tsx","../src/components/ExecutionConfigDisplay/ExecutionConfigDisplay.tsx","../src/components/network/NetworkSettingsDialog.tsx","../src/components/WalletConnectionWithSettings.tsx"],"sourcesContent":[],"mappings":"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"}

package/dist/index.mjs

@@ -733,6 +733,44 @@ function extractRuntimeSecrets(data, fields) {
 	};
 }
 
+//#endregion
+//#region src/utils/transactionSuccessCallback.ts
+/**
+* Normalizes adapter `txHash` for the success callback (non-empty trimmed string or omitted).
+* Expects the `txHash` string from `signAndBroadcast`, not arbitrary values (avoids coercing objects).
+*/
+function normalizeTransactionSuccessHash(finalTxHash) {
+	if (finalTxHash == null) return;
+	const trimmed = finalTxHash.trim();
+	return trimmed !== "" ? trimmed : void 0;
+}
+/**
+* Builds the {@link TransactionSuccessPayload} passed to `onTransactionSuccess`.
+*/
+function buildTransactionSuccessPayload(options) {
+	const hash = normalizeTransactionSuccessHash(options.finalTxHash);
+	return {
+		network_id: options.networkId,
+		ecosystem: options.ecosystem,
+		execution_method: options.executionMethod,
+		...hash !== void 0 ? { transaction_hash: hash } : {}
+	};
+}
+/**
+* Invokes `onTransactionSuccess` with error containment: synchronous throws and async
+* rejections are logged and never rethrown, so host callbacks cannot break transaction flow.
+*/
+function invokeOnTransactionSuccess(callback, payload, log) {
+	try {
+		const maybePromise = callback?.(payload);
+		Promise.resolve(maybePromise).catch((error) => {
+			log.error("TransactionForm", "onTransactionSuccess callback rejected with an error", error);
+		});
+	} catch (error) {
+		log.error("TransactionForm", "onTransactionSuccess callback threw an error", error);
+	}
+}
+
 //#endregion
 //#region src/components/fieldRegistry.ts
 /**
@@ -1180,7 +1218,7 @@ const PENDING_STATES = [
 *
 * @returns The rendered form component
 */
-function TransactionForm({ schema, contractSchema, adapter, isWalletConnected = false, executionConfig }) {
+function TransactionForm({ schema, contractSchema, adapter, isWalletConnected = false, executionConfig, onTransactionSuccess }) {
 	const [formError, setFormError] = useState(null);
 	const [executionConfigError, setExecutionConfigError] = useState(null);
 	const [runtimeApiKey, setRuntimeApiKey] = useState("");
@@ -1267,9 +1305,19 @@ function TransactionForm({ schema, contractSchema, adapter, isWalletConnected =
 				setTxResult(result);
 				logger.info("TransactionForm", "Execution result received:", result);
 			}
+			const reportTransactionSuccess = () => {
+				const executionMethod = executionConfig?.method ?? "eoa";
+				invokeOnTransactionSuccess(onTransactionSuccess, buildTransactionSuccessPayload({
+					networkId: adapter.networkConfig.id,
+					ecosystem: adapter.networkConfig.ecosystem,
+					executionMethod,
+					finalTxHash
+				}), logger);
+			};
 			if (canExecuteLocally) {
 				setTxStatus("success");
 				setTxError(null);
+				reportTransactionSuccess();
 				return;
 			}
 			if (adapter.waitForTransactionConfirmation) {
@@ -1280,6 +1328,7 @@ function TransactionForm({ schema, contractSchema, adapter, isWalletConnected =
 					logger.info("TransactionForm", `Transaction confirmed: ${finalTxHash}`, confirmationResult.receipt);
 					setTxStatus("success");
 					setTxError(null);
+					reportTransactionSuccess();
 				} else {
 					logger.error("TransactionForm", `Transaction failed confirmation: ${finalTxHash}`, confirmationResult.error);
 					setTxError(confirmationResult.error?.message ?? "Transaction failed during confirmation.");
@@ -1289,6 +1338,7 @@ function TransactionForm({ schema, contractSchema, adapter, isWalletConnected =
 				logger.warn("TransactionForm", "Adapter does not support waitForTransactionConfirmation. Marking as success after submission.");
 				setTxStatus("success");
 				setTxError(null);
+				reportTransactionSuccess();
 			}
 		} catch (error) {
 			logger.error("TransactionForm", "Transaction error during submission process:", error);
@@ -2780,5 +2830,5 @@ const WalletConnectionWithSettings = () => {
 };
 
 //#endregion
-export { AddressBookWidget, AliasEditPopover, ContractActionBar, ContractStateWidget, DynamicFormField, ExecutionConfigDisplay, NetworkSettingsDialog, TransactionExecuteButton, TransactionForm, WalletConnectionWithSettings, createAddressTransform, createArrayObjectTransform, createArrayTransform, createBigIntTransform, createBooleanTransform, createComplexTypeTransform, createDefaultFormValues, createNumberTransform, createObjectTransform, createTextTransform, createTransformForFieldType, generateDefaultValue, getDefaultValueByFieldType, rendererConfig, useAliasEditState, validateField };
+export { AddressBookWidget, AliasEditPopover, ContractActionBar, ContractStateWidget, DynamicFormField, ExecutionConfigDisplay, NetworkSettingsDialog, TransactionExecuteButton, TransactionForm, WalletConnectionWithSettings, buildTransactionSuccessPayload, createAddressTransform, createArrayObjectTransform, createArrayTransform, createBigIntTransform, createBooleanTransform, createComplexTypeTransform, createDefaultFormValues, createNumberTransform, createObjectTransform, createTextTransform, createTransformForFieldType, generateDefaultValue, getDefaultValueByFieldType, invokeOnTransactionSuccess, normalizeTransactionSuccessHash, rendererConfig, useAliasEditState, validateField };
 //# sourceMappingURL=index.mjs.map