@tetsuo-ai/marketplace-react 0.1.0 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +29 -3
- package/README.md +50 -20
- package/dist/{chunk-ABS77JB2.js → chunk-D2TDU3TJ.js} +3 -3
- package/dist/{chunk-ABS77JB2.js.map → chunk-D2TDU3TJ.js.map} +1 -1
- package/dist/{chunk-GN5DYVN5.js → chunk-ECU7HGO3.js} +6 -5
- package/dist/chunk-ECU7HGO3.js.map +1 -0
- package/dist/{chunk-YORZNYZZ.js → chunk-FAIRTAIB.js} +53 -17
- package/dist/chunk-FAIRTAIB.js.map +1 -0
- package/dist/{chunk-5OTKSRHM.js → chunk-MNJ2EQDJ.js} +3 -3
- package/dist/{chunk-5OTKSRHM.js.map → chunk-MNJ2EQDJ.js.map} +1 -1
- package/dist/{chunk-KJMR6OGC.js → chunk-WJUVTFJ7.js} +105 -9
- package/dist/chunk-WJUVTFJ7.js.map +1 -0
- package/dist/components/agenc-components.css +20 -0
- package/dist/components/index.cjs +147 -17
- package/dist/components/index.cjs.map +1 -1
- package/dist/components/index.d.cts +2 -2
- package/dist/components/index.d.ts +2 -2
- package/dist/components/index.js +3 -3
- package/dist/hooks/index.cjs +350 -28
- package/dist/hooks/index.cjs.map +1 -1
- package/dist/hooks/index.d.cts +160 -36
- package/dist/hooks/index.d.ts +160 -36
- package/dist/hooks/index.js +299 -19
- package/dist/hooks/index.js.map +1 -1
- package/dist/{index-BLrlBVj-.d.cts → index-C9R3B80j.d.ts} +176 -47
- package/dist/{index-CKTYsNPH.d.ts → index-CTTh1ZPg.d.cts} +176 -47
- package/dist/index.cjs +168 -33
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +10 -19
- package/dist/index.d.ts +10 -19
- package/dist/index.js +17 -12
- package/dist/index.js.map +1 -1
- package/dist/signers/index.cjs +4 -3
- package/dist/signers/index.cjs.map +1 -1
- package/dist/signers/index.js +2 -2
- package/dist/{useAgentTrackRecord-BLf1nrbu.d.cts → useAgentTrackRecord-BCvRHYM2.d.cts} +7 -7
- package/dist/{useAgentTrackRecord-BLf1nrbu.d.ts → useAgentTrackRecord-BCvRHYM2.d.ts} +7 -7
- package/package.json +4 -3
- package/src/components/HireButton.tsx +1 -2
- package/src/components/HireCheckoutModal.tsx +8 -9
- package/src/components/ProviderCard.stories.tsx +54 -4
- package/src/components/ProviderCard.tsx +113 -9
- package/src/components/ReferrerDisclosure.tsx +8 -12
- package/src/components/__fixtures__/index.tsx +28 -0
- package/src/components/agenc-components.css +20 -0
- package/src/components/index.ts +12 -0
- package/src/components/strings.ts +10 -2
- package/src/components/useAgentVerification.ts +223 -0
- package/src/hooks/index.ts +47 -4
- package/src/hooks/internal.ts +74 -2
- package/src/hooks/useHire.ts +30 -38
- package/src/hooks/useHumanlessHireFlow.ts +259 -0
- package/src/hooks/useRateHire.ts +52 -0
- package/src/hooks/useReferrerEarnings.ts +32 -33
- package/src/hooks/useTaskActivation.ts +58 -0
- package/src/hooks/useTaskLifecycle.ts +110 -0
- package/src/hooks/useTaskWork.ts +76 -0
- package/src/index.ts +12 -2
- package/src/provider/AgencProvider.tsx +3 -3
- package/src/provider/referrer.ts +24 -32
- package/src/strings/index.ts +5 -3
- package/src/types.ts +7 -10
- package/dist/chunk-GN5DYVN5.js.map +0 -1
- package/dist/chunk-KJMR6OGC.js.map +0 -1
- package/dist/chunk-YORZNYZZ.js.map +0 -1
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { ReactNode, ButtonHTMLAttributes, HTMLAttributes, RefObject } from 'react';
|
|
2
|
-
import { ListActiveListingsOptions, DecodedProgramAccount, ServiceListing, IndexerListing, IndexerHire, IndexerAgentTrackRecord, MarketplaceClient, ProgramAccountsTransport, CreateIndexerClientOptions, TaskStatus } from '@tetsuo-ai/marketplace-sdk';
|
|
2
|
+
import { ListActiveListingsOptions, DecodedProgramAccount, ServiceListing, IndexerListing, IndexerHire, IndexerAgentTrackRecord, MarketplaceClient, ProgramAccountsTransport, CreateIndexerClientOptions, TaskStatus, fetchMaybeAgentVerification, AgentVerification } from '@tetsuo-ai/marketplace-sdk';
|
|
3
3
|
import { Address, TransactionSigner, Rpc, GetProgramAccountsApi } from '@solana/kit';
|
|
4
|
-
import {
|
|
4
|
+
import { f as HireStatus, b as AnyHireInput, i as ReviewStatus, c as DisputeStatus, a as AgentTrackRecord } from './useAgentTrackRecord-BCvRHYM2.js';
|
|
5
5
|
|
|
6
6
|
/**
|
|
7
7
|
* Shared types for `@tetsuo-ai/marketplace-react`.
|
|
@@ -88,8 +88,8 @@ interface CreateReadTransportConfig {
|
|
|
88
88
|
type AgencNetwork = "localnet" | "devnet" | "mainnet";
|
|
89
89
|
/**
|
|
90
90
|
* Referrer configuration. Accepted + validated + stored ALWAYS; injected into
|
|
91
|
-
* hires only when {@link ReferrerCapability.live} is true
|
|
92
|
-
*
|
|
91
|
+
* hires only when {@link ReferrerCapability.live} is true. See
|
|
92
|
+
* {@link resolveReferrerCapability}.
|
|
93
93
|
*/
|
|
94
94
|
interface ReferrerConfig {
|
|
95
95
|
/** Referrer wallet that earns the fee. Must be a valid base58 address. */
|
|
@@ -114,11 +114,9 @@ interface ValidatedReferrerConfig {
|
|
|
114
114
|
* The runtime answer to "can a referral fee actually be charged on this
|
|
115
115
|
* cluster?". Returned by `resolveReferrerCapability()`.
|
|
116
116
|
*
|
|
117
|
-
*
|
|
118
|
-
*
|
|
119
|
-
*
|
|
120
|
-
* referrer is never injected, earnings hooks return a documented not-live
|
|
121
|
-
* state, and disclosure UI may still show the pending-support copy.
|
|
117
|
+
* Referrer settlement is live on the full 84-instruction surface. `live` is true
|
|
118
|
+
* when a validated provider referrer is configured. Aggregated earnings remain a
|
|
119
|
+
* separate indexer-gated read surface.
|
|
122
120
|
*/
|
|
123
121
|
interface ReferrerCapability {
|
|
124
122
|
/** Whether referral settlement is live on the target cluster. */
|
|
@@ -144,7 +142,7 @@ interface AgencProviderConfig {
|
|
|
144
142
|
rpcSubscriptionsUrl?: string;
|
|
145
143
|
/** Indexer connection — presence of `indexer.baseUrl` selects indexer-first. */
|
|
146
144
|
indexer?: IndexerConfig;
|
|
147
|
-
/** Referrer config (accepted + validated; injected
|
|
145
|
+
/** Referrer config (accepted + validated; injected into hire transactions). */
|
|
148
146
|
referrer?: ReferrerConfig;
|
|
149
147
|
/** Signer for write operations (the kit `TransactionSigner`). */
|
|
150
148
|
signer?: TransactionSigner;
|
|
@@ -179,8 +177,7 @@ interface AgencContextValue {
|
|
|
179
177
|
/** Validated referrer config, or `null` when none was supplied. */
|
|
180
178
|
referrer: ValidatedReferrerConfig | null;
|
|
181
179
|
/**
|
|
182
|
-
* Resolve whether
|
|
183
|
-
* gate). Today always `{ live: false, ... }`.
|
|
180
|
+
* Resolve whether this provider has a live referral-settlement config.
|
|
184
181
|
*/
|
|
185
182
|
resolveReferrerCapability(): ReferrerCapability;
|
|
186
183
|
}
|
|
@@ -223,8 +220,9 @@ declare const EN_STRINGS: {
|
|
|
223
220
|
readonly "provider.missingSigner": "No signer is configured on <AgencProvider>. Connect a wallet or pass config.signer.";
|
|
224
221
|
readonly "referrer.invalidWallet": "Referrer wallet is not a valid base58 Solana address: {wallet}.";
|
|
225
222
|
readonly "referrer.invalidFeeBps": "Referrer feeBps must be an integer between {min} and {max} (basis points); got {feeBps}.";
|
|
226
|
-
readonly "referrer.notLive": "
|
|
227
|
-
readonly "referrer.notLiveReason": "
|
|
223
|
+
readonly "referrer.notLive": "Referral fee is not active for this hire.";
|
|
224
|
+
readonly "referrer.notLiveReason": "No referrer is configured for this provider.";
|
|
225
|
+
readonly "referrer.earningsNotLiveReason": "Referral settlement is live, but aggregated referrer earnings are not yet exposed by the indexer.";
|
|
228
226
|
readonly "transport.noReadSource": "No read source is configured. Pass an indexer baseUrl, an rpc/queryTransport, to <AgencProvider> or createReadTransport().";
|
|
229
227
|
readonly "state.loading": "Loading…";
|
|
230
228
|
readonly "state.empty": "Nothing to show yet.";
|
|
@@ -481,7 +479,7 @@ declare const EN_COMPONENT_STRINGS: {
|
|
|
481
479
|
readonly "components.hire.moderationIssues": "Moderation issues found";
|
|
482
480
|
readonly "components.hire.notConnected": "Connect a wallet to hire.";
|
|
483
481
|
readonly "components.referrer.disclosure": "This site earns a referral fee.";
|
|
484
|
-
readonly "components.referrer.disclosurePending": "
|
|
482
|
+
readonly "components.referrer.disclosurePending": "Referral fee is not active for this hire.";
|
|
485
483
|
readonly "components.referrer.feeBps": "{bps} bps";
|
|
486
484
|
readonly "components.taskTimeline.title": "Task progress";
|
|
487
485
|
readonly "components.taskTimeline.empty": "No task to track yet.";
|
|
@@ -517,6 +515,10 @@ declare const EN_COMPONENT_STRINGS: {
|
|
|
517
515
|
readonly "components.provider.provisional": "provisional";
|
|
518
516
|
readonly "components.provider.noData": "No track record yet.";
|
|
519
517
|
readonly "components.provider.unavailable": "Track record is unavailable on this read transport.";
|
|
518
|
+
readonly "components.provider.verifiedDomain": "Verified: {domain}";
|
|
519
|
+
readonly "components.provider.verifiedDomainLabel": "Verified domain {domain}";
|
|
520
|
+
readonly "components.provider.claimedDomain": "Claims: {domain}";
|
|
521
|
+
readonly "components.provider.claimedDomainLabel": "Claimed domain {domain} (not verified on-chain)";
|
|
520
522
|
readonly "components.poweredBy.label": "Powered by AgenC";
|
|
521
523
|
readonly "components.poweredBy.trustLink": "Learn how this works";
|
|
522
524
|
};
|
|
@@ -770,8 +772,8 @@ declare function ListingGrid({ listings, isLoading, error, hasMore, onLoadMore,
|
|
|
770
772
|
* `<HireCheckoutModal>` — the embeddable money path (PLAN_2 A3).
|
|
771
773
|
*
|
|
772
774
|
* The accessible, themable checkout dialog: it shows the price, the moderation
|
|
773
|
-
* attestation badge, the escrow-funding explanation, the referrer disclosure
|
|
774
|
-
*
|
|
775
|
+
* attestation badge, the escrow-funding explanation, the referrer disclosure,
|
|
776
|
+
* and walks the buyer through idle → confirming → funded /
|
|
775
777
|
* error confirmation states.
|
|
776
778
|
*
|
|
777
779
|
* ## Accessibility (STRUCTURAL — this is published to third parties)
|
|
@@ -781,12 +783,11 @@ declare function ListingGrid({ listings, isLoading, error, hasMore, onLoadMore,
|
|
|
781
783
|
* transaction), ARIA dialog roles, and live-region status announcements for
|
|
782
784
|
* the confirming/funded/error transitions.
|
|
783
785
|
*
|
|
784
|
-
* ##
|
|
786
|
+
* ## Referrer disclosure
|
|
785
787
|
*
|
|
786
|
-
* The disclosure renders when a `referrer` is configured
|
|
787
|
-
*
|
|
788
|
-
*
|
|
789
|
-
* only. Injection/earnings stay in the hooks, blocked on P6.2.
|
|
788
|
+
* The disclosure renders when a `referrer` is configured. The modal never
|
|
789
|
+
* computes earnings; injection lives in `useHire()` and aggregate earnings live
|
|
790
|
+
* in `useReferrerEarnings()`.
|
|
790
791
|
*
|
|
791
792
|
* ## Wiring
|
|
792
793
|
*
|
|
@@ -833,8 +834,8 @@ interface HireCheckoutModalProps {
|
|
|
833
834
|
*/
|
|
834
835
|
referrer?: ValidatedReferrerConfig | null;
|
|
835
836
|
/**
|
|
836
|
-
* Whether referral settlement is
|
|
837
|
-
*
|
|
837
|
+
* Whether referral settlement is active for this hire. Drives the disclosure
|
|
838
|
+
* copy only; never computes earnings.
|
|
838
839
|
*/
|
|
839
840
|
referrerLive?: boolean;
|
|
840
841
|
/** Whether a signer/wallet is connected (gates the confirm button). */
|
|
@@ -855,8 +856,7 @@ declare function HireCheckoutModal({ open, onClose, listing, onConfirm, status,
|
|
|
855
856
|
* This is the one component that binds the hooks directly: it renders a price-
|
|
856
857
|
* aware CTA that opens {@link HireCheckoutModal}, drives the hire through
|
|
857
858
|
* `useHire()`, resolves the signer via `useWalletSigner()`, and threads the
|
|
858
|
-
* provider's configured referrer +
|
|
859
|
-
* disclosure (never injecting a fee — the gate lives in `useHire`).
|
|
859
|
+
* provider's configured referrer + capability into the modal's disclosure.
|
|
860
860
|
*
|
|
861
861
|
* ## Why the caller supplies the hire input
|
|
862
862
|
*
|
|
@@ -913,14 +913,11 @@ declare function HireButton({ listing, buildHireInput, onHired, onViewTask, show
|
|
|
913
913
|
/**
|
|
914
914
|
* `<ReferrerDisclosure>` — the "this site earns a referral fee" notice.
|
|
915
915
|
*
|
|
916
|
-
* ##
|
|
916
|
+
* ## Referral disclosure
|
|
917
917
|
*
|
|
918
|
-
* Disclosure is
|
|
919
|
-
*
|
|
920
|
-
*
|
|
921
|
-
* informational and reads no earnings. The actual injection / earnings remain
|
|
922
|
-
* blocked on P6.2 (handled by the hooks, not here). This component only
|
|
923
|
-
* DISCLOSES the configured intent.
|
|
918
|
+
* Disclosure is informational and reads no earnings. When `live` is true it can
|
|
919
|
+
* use the present-tense fee copy. When `live` is false it shows neutral copy and
|
|
920
|
+
* does not imply a fee was charged.
|
|
924
921
|
*
|
|
925
922
|
* Render it only when a referrer is configured on the provider.
|
|
926
923
|
*
|
|
@@ -932,17 +929,16 @@ interface ReferrerDisclosureProps extends ThemableProps {
|
|
|
932
929
|
/** The validated referrer config (from the provider context). */
|
|
933
930
|
referrer: ValidatedReferrerConfig;
|
|
934
931
|
/**
|
|
935
|
-
* Whether the referral fee is
|
|
936
|
-
*
|
|
937
|
-
* no fee is implied as charged. Defaults to false.
|
|
932
|
+
* Whether the referral fee is active for this hire. When false, no fee is
|
|
933
|
+
* implied as charged. Defaults to false.
|
|
938
934
|
*/
|
|
939
935
|
live?: boolean;
|
|
940
936
|
/** Show the configured fee in bps alongside the disclosure. Default true. */
|
|
941
937
|
showFee?: boolean;
|
|
942
938
|
}
|
|
943
939
|
/**
|
|
944
|
-
* Disclose that the embedding site earns a referral fee
|
|
945
|
-
*
|
|
940
|
+
* Disclose that the embedding site earns a referral fee when referral settlement
|
|
941
|
+
* is active for the hire.
|
|
946
942
|
*/
|
|
947
943
|
declare function ReferrerDisclosure({ referrer, live, showFee, unstyled, className, }: ReferrerDisclosureProps): ReactNode;
|
|
948
944
|
|
|
@@ -1054,13 +1050,129 @@ interface DisputeBannerProps extends ThemableProps {
|
|
|
1054
1050
|
declare function DisputeBanner({ disputeOpen, onInitiate, status, error, unstyled, className, }: DisputeBannerProps): ReactNode;
|
|
1055
1051
|
|
|
1056
1052
|
/**
|
|
1057
|
-
*
|
|
1053
|
+
* The decoded, projected verification result for an agent — the PINNED P7.3(3)
|
|
1054
|
+
* shape. When no live verification exists this is `{ verified: false }` (the
|
|
1055
|
+
* narrow "absent / revoked / expired" case); otherwise every field is present
|
|
1056
|
+
* and `verified` is `true`.
|
|
1057
|
+
*/
|
|
1058
|
+
type AgentVerificationResult = {
|
|
1059
|
+
/** A live, on-chain, non-revoked, non-expired verification exists. */
|
|
1060
|
+
verified: true;
|
|
1061
|
+
/** The on-chain VERIFIED operator domain (proven, not self-claimed). */
|
|
1062
|
+
domain: string;
|
|
1063
|
+
/** Proof method: `0` = DNS `TXT`, `1` = `.well-known` over HTTPS. */
|
|
1064
|
+
method: number;
|
|
1065
|
+
/** The attestor/authority that recorded this verification. */
|
|
1066
|
+
verifiedBy: Address | string;
|
|
1067
|
+
/** Unix-seconds timestamp the verification was recorded. */
|
|
1068
|
+
verifiedAt: bigint;
|
|
1069
|
+
/** Unix-seconds expiry, or `0n` for no expiry. */
|
|
1070
|
+
expiresAt: bigint;
|
|
1071
|
+
/** Always `false` here (a revoked record is never `verified: true`). */
|
|
1072
|
+
revoked: false;
|
|
1073
|
+
} | {
|
|
1074
|
+
/** No live verification — account absent, revoked, or expired. */
|
|
1075
|
+
verified: false;
|
|
1076
|
+
};
|
|
1077
|
+
/** The unverified sentinel (frozen so callers can compare identity cheaply). */
|
|
1078
|
+
declare const UNVERIFIED: AgentVerificationResult;
|
|
1079
|
+
/**
|
|
1080
|
+
* Decide whether a decoded `AgentVerification` account is a LIVE verification:
|
|
1081
|
+
* it must NOT be revoked AND must not be expired (`expiresAt === 0n` = no
|
|
1082
|
+
* expiry; otherwise `nowSeconds < expiresAt`). Pure + exported so structural
|
|
1083
|
+
* tests assert the revoked/expired/absent boundaries directly.
|
|
1084
|
+
*
|
|
1085
|
+
* @param account - The decoded account, or `null`/`undefined` when absent.
|
|
1086
|
+
* @param nowSeconds - Current unix-seconds (injected for determinism).
|
|
1087
|
+
*/
|
|
1088
|
+
declare function evaluateAgentVerification(account: AgentVerification | null | undefined, nowSeconds: bigint): AgentVerificationResult;
|
|
1089
|
+
/**
|
|
1090
|
+
* A function that resolves the raw verification for an agent PDA to the pinned
|
|
1091
|
+
* result shape. Injected so the hook stays decoupled from any specific read
|
|
1092
|
+
* backend (kit RPC, the storefront track-record endpoint, a test stub).
|
|
1093
|
+
*/
|
|
1094
|
+
type AgentVerificationReader = (agentPda: Address | string) => Promise<AgentVerificationResult>;
|
|
1095
|
+
/** The minimal kit-RPC surface {@link agentVerificationReaderFromRpc} needs. */
|
|
1096
|
+
type AgentVerificationRpc = Parameters<typeof fetchMaybeAgentVerification>[0];
|
|
1097
|
+
/** Options for {@link agentVerificationReaderFromRpc}. */
|
|
1098
|
+
interface AgentVerificationReaderOptions {
|
|
1099
|
+
/**
|
|
1100
|
+
* Clock source (unix seconds) used to evaluate expiry. Defaults to
|
|
1101
|
+
* `Date.now()`-derived; inject a fixed value in tests/SSR for determinism.
|
|
1102
|
+
*/
|
|
1103
|
+
now?: () => bigint;
|
|
1104
|
+
}
|
|
1105
|
+
/**
|
|
1106
|
+
* Build an {@link AgentVerificationReader} over a kit RPC using the SDK's
|
|
1107
|
+
* `findAgentVerificationPda` (the `["agent_verification", agent]` seed) +
|
|
1108
|
+
* `fetchMaybeAgentVerification` (the regenerated decoder). An absent account
|
|
1109
|
+
* yields `{ verified: false }` (never throws on absence).
|
|
1110
|
+
*
|
|
1111
|
+
* @param rpc - A kit RPC capable of `getAccountInfo` (what the SDK fetch needs).
|
|
1112
|
+
* @param options - Optional `now` clock injection.
|
|
1113
|
+
*/
|
|
1114
|
+
declare function agentVerificationReaderFromRpc(rpc: AgentVerificationRpc, options?: AgentVerificationReaderOptions): AgentVerificationReader;
|
|
1115
|
+
/** Options for {@link useAgentVerification}. */
|
|
1116
|
+
interface UseAgentVerificationOptions {
|
|
1117
|
+
/**
|
|
1118
|
+
* The reader that resolves the on-chain verification. When omitted the hook
|
|
1119
|
+
* is inert (returns the unverified result, never queries) — a host opts in by
|
|
1120
|
+
* passing {@link agentVerificationReaderFromRpc} or a custom resolver.
|
|
1121
|
+
*/
|
|
1122
|
+
reader?: AgentVerificationReader;
|
|
1123
|
+
/** Disable the query. Default `true` when `agentPda` and a `reader` are set. */
|
|
1124
|
+
enabled?: boolean;
|
|
1125
|
+
}
|
|
1126
|
+
/** Return value of {@link useAgentVerification}. */
|
|
1127
|
+
interface UseAgentVerificationResult {
|
|
1128
|
+
/** The resolved verification (defaults to the unverified result). */
|
|
1129
|
+
verification: AgentVerificationResult;
|
|
1130
|
+
/** Convenience: `verification.verified`. */
|
|
1131
|
+
verified: boolean;
|
|
1132
|
+
/** True while the verification read is in flight. */
|
|
1133
|
+
isLoading: boolean;
|
|
1134
|
+
/** A read error, or `null`. A failed read is NEVER treated as verified. */
|
|
1135
|
+
error: Error | null;
|
|
1136
|
+
/** Force a refetch. */
|
|
1137
|
+
refetch: () => void;
|
|
1138
|
+
}
|
|
1139
|
+
/**
|
|
1140
|
+
* Read an agent's on-chain verification (P7.3) into the pinned result shape.
|
|
1141
|
+
*
|
|
1142
|
+
* Defensive by construction: with no `reader`, no resolved data, or a read
|
|
1143
|
+
* error, the result is `{ verified: false }` — an agent is shown verified ONLY
|
|
1144
|
+
* when a live on-chain attestation is actually read back. A self-claimed
|
|
1145
|
+
* `operatorDomain` never reaches this hook.
|
|
1146
|
+
*
|
|
1147
|
+
* @param agentPda - The AgentRegistration PDA (falsy disables the hook).
|
|
1148
|
+
* @param options - The `reader` to resolve with + an `enabled` override.
|
|
1149
|
+
* @returns {@link UseAgentVerificationResult}.
|
|
1150
|
+
*/
|
|
1151
|
+
declare function useAgentVerification(agentPda: Address | string | undefined | null, options?: UseAgentVerificationOptions): UseAgentVerificationResult;
|
|
1152
|
+
|
|
1153
|
+
/**
|
|
1154
|
+
* `<ProviderCard>` — a provider's reputation + trust summary.
|
|
1058
1155
|
*
|
|
1059
1156
|
* Renders the agent's track record (completion rate, dispute rate, completions,
|
|
1060
|
-
* dispute count
|
|
1061
|
-
* takes the projected `AgentTrackRecord | null` (from
|
|
1062
|
-
* `useAgentTrackRecord().trackRecord`)
|
|
1063
|
-
*
|
|
1157
|
+
* dispute count) plus an on-chain VERIFIED badge and the operator domain.
|
|
1158
|
+
* Presentational: it takes the projected `AgentTrackRecord | null` (from
|
|
1159
|
+
* `useAgentTrackRecord().trackRecord`) and the resolved
|
|
1160
|
+
* `AgentVerificationResult` (from `useAgentVerification().verification`) +
|
|
1161
|
+
* loading/error, so it renders under SSR and in Ladle.
|
|
1162
|
+
*
|
|
1163
|
+
* ## P7.3(3) claimed vs verified — the trust distinction
|
|
1164
|
+
*
|
|
1165
|
+
* The provider may CLAIM an `operatorDomain` in its agent metadata; that is
|
|
1166
|
+
* self-reported and unproven. The trust signal is the on-chain
|
|
1167
|
+
* `AgentVerification` PDA, written by a trusted attestor only after the operator
|
|
1168
|
+
* PROVED domain control. This card NEVER conflates the two:
|
|
1169
|
+
* - a live verification (`verification.verified === true`) renders a "Verified:
|
|
1170
|
+
* <domain>" badge using the ON-CHAIN `verification.domain` (a success pill);
|
|
1171
|
+
* - otherwise, the merely-CLAIMED `operatorDomain` (when supplied) renders as a
|
|
1172
|
+
* visibly distinct "Claims: <domain>" pill — never styled or labelled as
|
|
1173
|
+
* verified.
|
|
1174
|
+
* An unverified claimed domain therefore can never read as verified, even when
|
|
1175
|
+
* the claimed string happens to equal a domain someone else verified.
|
|
1064
1176
|
*
|
|
1065
1177
|
* ## P6.6 honesty
|
|
1066
1178
|
*
|
|
@@ -1077,7 +1189,24 @@ interface ProviderCardProps extends ThemableProps {
|
|
|
1077
1189
|
agent?: Address | string | null;
|
|
1078
1190
|
/** The projected track record (from `useAgentTrackRecord().trackRecord`). */
|
|
1079
1191
|
trackRecord: AgentTrackRecord | null;
|
|
1080
|
-
/**
|
|
1192
|
+
/**
|
|
1193
|
+
* The resolved ON-CHAIN verification (from
|
|
1194
|
+
* `useAgentVerification().verification`). Defaults to the unverified result,
|
|
1195
|
+
* so omitting it renders the provider as NOT verified — verified state is
|
|
1196
|
+
* opt-in and only ever driven by a live attestation.
|
|
1197
|
+
*/
|
|
1198
|
+
verification?: AgentVerificationResult;
|
|
1199
|
+
/**
|
|
1200
|
+
* The provider's CLAIMED operator domain (from agent metadata). Self-reported
|
|
1201
|
+
* and UNPROVEN — shown as a clearly-distinct "claimed" pill, and only when no
|
|
1202
|
+
* on-chain verification supersedes it. Never rendered as verified.
|
|
1203
|
+
*/
|
|
1204
|
+
operatorDomain?: string | null;
|
|
1205
|
+
/**
|
|
1206
|
+
* Deprecated boolean verified flag (pre-P7.3). When `verification` is omitted,
|
|
1207
|
+
* a `true` here still shows the legacy verified badge, but WITHOUT a domain
|
|
1208
|
+
* (no on-chain domain is available from a bare boolean). Prefer `verification`.
|
|
1209
|
+
*/
|
|
1081
1210
|
verified?: boolean;
|
|
1082
1211
|
/** True while loading the track record. */
|
|
1083
1212
|
isLoading?: boolean;
|
|
@@ -1090,9 +1219,9 @@ interface ProviderCardProps extends ThemableProps {
|
|
|
1090
1219
|
onRetry?: () => void;
|
|
1091
1220
|
}
|
|
1092
1221
|
/**
|
|
1093
|
-
* Render a provider reputation card.
|
|
1222
|
+
* Render a provider reputation + trust card.
|
|
1094
1223
|
*/
|
|
1095
|
-
declare function ProviderCard({ agent, trackRecord, verified, isLoading, error, onRetry, unstyled, className, }: ProviderCardProps): ReactNode;
|
|
1224
|
+
declare function ProviderCard({ agent, trackRecord, verification, operatorDomain, verified, isLoading, error, onRetry, unstyled, className, }: ProviderCardProps): ReactNode;
|
|
1096
1225
|
|
|
1097
1226
|
/**
|
|
1098
1227
|
* `<PoweredByAgenC>` — an optional attribution badge linking a trust page.
|
|
@@ -1126,4 +1255,4 @@ interface PoweredByAgenCProps extends ThemableProps {
|
|
|
1126
1255
|
*/
|
|
1127
1256
|
declare function PoweredByAgenC({ href, newTab, label, unstyled, className, }: PoweredByAgenCProps): ReactNode;
|
|
1128
1257
|
|
|
1129
|
-
export { type
|
|
1258
|
+
export { type StateKind as $, type AgencProviderConfig as A, Badge as B, type CreateReadTransportConfig as C, DEFAULT_TRUST_HREF as D, EN_COMPONENT_STRINGS as E, type ModalProps as F, type GpaReadSource as G, HireButton as H, type IndexerConfig as I, ModerationBadge as J, type ModerationBadgeProps as K, ListingCard as L, Modal as M, type ModerationState as N, type PoweredByAgenCProps as O, PoweredByAgenC as P, ProviderCard as Q, type ReferrerCapability as R, type ProviderCardProps as S, type ReadListingResult as T, ReferrerDisclosure as U, type ValidatedReferrerConfig as V, type ReferrerDisclosureProps as W, ReviewPanel as X, type ReviewPanelProps as Y, Spinner as Z, type SpinnerProps as _, type AgencContextValue as a, StateMessage as a0, type StateMessageProps as a1, type StringCatalog as a2, type StringId as a3, type StringVars as a4, TaskTimeline as a5, type TaskTimelineProps as a6, type ThemableProps as a7, type TranslateOptions as a8, UNVERIFIED as a9, type UseAgentVerificationOptions as aa, type UseAgentVerificationResult as ab, VerifiedBadge as ac, type VerifiedBadgeProps as ad, agentVerificationReaderFromRpc as ae, cx as af, decodeListingCategory as ag, decodeListingName as ah, decodeListingTags as ai, elementClass as aj, evaluateAgentVerification as ak, formatPriceSol as al, formatRate as am, formatSol as an, moderationStateOf as ao, rootClass as ap, t as aq, tc as ar, toHex as as, truncateAddress as at, useAgentVerification as au, useFocusTrap as av, type ReferrerConfig as b, type AgencNetwork as c, type ReadTransport as d, type AgentVerificationReader as e, type AgentVerificationReaderOptions as f, type AgentVerificationResult as g, type AgentVerificationRpc as h, type BadgeProps as i, type BadgeTone as j, Button as k, type ButtonProps as l, type ButtonVariant as m, COMPONENT_CATALOG as n, type ComponentStringId as o, DisputeBanner as p, type DisputeBannerProps as q, EN_STRINGS as r, type HireButtonProps as s, type HireCheckoutListing as t, HireCheckoutModal as u, type HireCheckoutModalProps as v, type ListingCardData as w, type ListingCardProps as x, ListingGrid as y, type ListingGridProps as z };
|