@openzeppelin/ui-renderer 1.1.0 → 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
@@ -284,6 +311,7 @@ declare function AddressBookWidget({
   networks,
   filterNetworkIds,
   onFilterNetworkIdsChange,
+  title,
   className
 }: AddressBookWidgetProps): react_jsx_runtime0.JSX.Element;
 //#endregion
@@ -418,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
@@ -284,6 +311,7 @@ declare function AddressBookWidget({
   networks,
   filterNetworkIds,
   onFilterNetworkIdsChange,
+  title,
   className
 }: AddressBookWidgetProps): react_jsx_runtime0.JSX.Element;
 //#endregion
@@ -418,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);
@@ -1733,7 +1783,7 @@ function ImportExportBar({ onExport, onImport, exportDisabled }) {
 //#endregion
 //#region src/components/AddressBookWidget/AddressBookWidget.tsx
 /** Widget for managing a personal address book with aliases, search, and network filtering. */
-function AddressBookWidget({ aliases, isLoading, onSave, onRemove, onClear, onExport, onImport, currentNetworkId, resolveNetwork, resolveExplorerUrl, adapter, resolveAdapter, addressPlaceholder, resolveAddressPlaceholder, networks, filterNetworkIds, onFilterNetworkIdsChange, className }) {
+function AddressBookWidget({ aliases, isLoading, onSave, onRemove, onClear, onExport, onImport, currentNetworkId, resolveNetwork, resolveExplorerUrl, adapter, resolveAdapter, addressPlaceholder, resolveAddressPlaceholder, networks, filterNetworkIds, onFilterNetworkIdsChange, title = "Address Book", className }) {
 	const [search, setSearch] = useState("");
 	const [addDialogOpen, setAddDialogOpen] = useState(false);
 	const [confirmClear, setConfirmClear] = useState(false);
@@ -1760,7 +1810,7 @@ function AddressBookWidget({ aliases, isLoading, onSave, onRemove, onClear, onEx
 		className: cn("w-full", className),
 		children: [/* @__PURE__ */ jsx(CardHeader, { children: /* @__PURE__ */ jsxs(CardTitle, {
 			className: "flex items-center gap-2 text-lg",
-			children: [/* @__PURE__ */ jsx(BookUser, { className: "h-5 w-5" }), "Address Book"]
+			children: [/* @__PURE__ */ jsx(BookUser, { className: "h-5 w-5" }), title]
 		}) }), /* @__PURE__ */ jsx(CardContent, {
 			className: "flex items-center justify-center py-12",
 			children: /* @__PURE__ */ jsx(Loader2, { className: "h-6 w-6 animate-spin text-muted-foreground" })
@@ -1775,7 +1825,7 @@ function AddressBookWidget({ aliases, isLoading, onSave, onRemove, onClear, onEx
 					className: "flex items-center gap-2 text-lg",
 					children: [
 						/* @__PURE__ */ jsx(BookUser, { className: "h-5 w-5" }),
-						"Address Book",
+						title,
 						aliases.length > 0 && /* @__PURE__ */ jsxs("span", {
 							className: "text-sm font-normal text-muted-foreground",
 							children: [
@@ -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