Home / TrueIntent / TrueIntent Specification
TrueIntent
Human Intent Verification for Federated Transactions
TrueIntent is an open-source, AI-powered transaction verification specification designed to ensure that individuals and organizations understand and explicitly authorize financial transactions before execution. Integrated directly into the SharedRail federation network, TrueIntent operates locally on participating federation nodes rather than relying on a centralized verification server.
When a Request for Payment (RFP) arrives, TrueIntent evaluates transaction characteristics, sender information, recipient history, payment amounts, jurisdictional risk indicators, and urgency language to identify circumstances requiring additional verification. Using locally hosted AI models, deterministic decision trees, and configurable risk policies, TrueIntent generates interactive questions that help recipients recognize potential risks and make informed authorization decisions.
TrueIntent combines human confirmation, AI-assisted risk assessment, cryptographic authorization records, and decentralized transaction controls to establish a transparent verification process. Each federation node retains control over its verification policies, risk thresholds, privacy settings, and transaction approval requirements.
Core Modules
Request for Payment Intake
- Receive incoming Requests for Payment from connected federation nodes, financial institutions, merchants, businesses, and authorized participants.
- Validate incoming request structure, required fields, sender identity, recipient information, and transaction metadata.
- Identify requesting entities, originating nodes, destination accounts, requested amounts, currencies, and transaction purposes.
- Validate transaction references and request identifiers.
- Detect duplicate, expired, modified, or previously processed requests.
- Identify discrepancies between original requests and subsequent modifications.
- Support standardized RFP formats and configurable integration protocols.
- Maintain transaction request status throughout the verification lifecycle.
- Reject malformed, unauthorized, or invalid requests before initiating confirmation.
Transaction Signal Evaluation
- Evaluate incoming transaction characteristics before authorization.
- Identify new or unfamiliar contacts and recipients.
- Detect significant changes in recipient account information.
- Evaluate transaction amounts against user-defined and node-defined thresholds.
- Identify unusually large or atypical transactions.
- Detect high-risk jurisdictions and configurable geographic restrictions.
- Identify urgency language, pressure tactics, and suspicious payment instructions.
- Detect unusual payment purposes, transaction patterns, and destination changes.
- Identify requests involving newly established relationships or previously unused payment destinations.
- Evaluate inconsistencies between sender identity and transaction information.
- Assign individual risk indicators and an overall preliminary risk classification.
- Support configurable signal weighting and evaluation criteria.
TrueIntent AI Engine
- Run open-source AI models directly on participating federation nodes.
- Generate context-sensitive verification questions based on transaction characteristics.
- Interpret transaction metadata and structured risk indicators.
- Identify potentially misleading language, impersonation attempts, coercive instructions, and social engineering indicators.
- Generate plain-language explanations of transaction risks.
- Adapt questions to transaction type, amount, recipient, and identified risk factors.
- Use deterministic logic trees to supplement AI-generated assessments.
- Separate factual transaction information from AI-generated interpretations.
- Provide transparent explanations for recommended verification steps.
- Support locally hosted language models and configurable model providers.
- Allow nodes to operate using deterministic rules when AI services are unavailable.
- Maintain versioned prompts, model configurations, and evaluation criteria.
- Prevent AI-generated recommendations from independently authorizing transactions.
- Ensure final authorization remains subject to explicit user consent and applicable node policies.
Interactive User Verification
- Present guided confirmation workflows to transaction recipients.
- Generate questions based on identified transaction risks.
- Confirm that recipients recognize the sender.
- Confirm that recipients understand the requested amount.
- Confirm that recipients recognize the destination account.
- Verify that recipients understand the stated transaction purpose.
- Explain suspicious urgency, unusual instructions, and potential impersonation risks.
- Allow users to request additional information before proceeding.
- Provide accessible, plain-language explanations.
- Support web, mobile, and other node-integrated interfaces.
- Allow users to decline, cancel, pause, or defer transaction authorization.
- Require explicit confirmation for designated transaction categories.
- Prevent preselected or automatically accepted consent responses.
- Require renewed confirmation when material transaction details change.
- Support additional verification for high-risk requests.
Risk Classification and Policy Engine
- Establish configurable low-, medium-, high-, and critical-risk classifications.
- Evaluate combinations of transaction signals rather than relying exclusively on individual indicators.
- Define node-specific risk thresholds and escalation requirements.
- Support maximum transaction amounts and daily authorization limits.
- Configure additional confirmation requirements based on transaction value.
- Establish mandatory co-signer requirements for designated transactions.
- Support configurable transaction waiting periods.
- Introduce temporary transaction holds for suspicious or incomplete requests.
- Require additional identity or authentication checks when appropriate.
- Allow nodes to define restricted jurisdictions and transaction categories.
- Support transaction-specific approval policies.
- Provide controlled policy overrides for authorized administrators.
- Maintain version-controlled policy configurations.
- Record the policy version used for each authorization decision.
Consent and Authorization Management
- Require explicit user authorization before transaction execution.
- Distinguish between acknowledging a warning and authorizing a transaction.
- Capture affirmative, negative, and deferred responses.
- Bind authorization to specific transaction details presented to the recipient.
- Prevent authorization from being reused for modified transaction requests.
- Require new authorization when transaction amounts, recipients, or destination accounts change.
- Support multi-step approval workflows.
- Support designated co-signers and additional authorized approvers.
- Provide configurable approval expiration periods.
- Prevent transaction execution when required confirmations are incomplete.
- Maintain separation between AI recommendations, policy decisions, and user authorization.
- Provide final transaction authorization status to the execution layer.
Cryptographic Confirmation Records
- Generate tamper-evident confirmation records.
- Cryptographically bind consent records to transaction identifiers and relevant transaction details.
- Record timestamps, confirmation status, applicable policy versions, and verification outcomes.
- Support digital signatures using established cryptographic standards.
- Support signed authorization receipts and verification records.
- Detect modifications to previously recorded confirmation metadata.
- Provide cryptographic verification of authorization records.
- Support configurable retention and archival policies.
- Minimize the collection of personally identifiable information.
- Protect confirmation records against unauthorized modification.
- Provide auditable evidence of authorization without unnecessarily exposing private user information.
Federation Node Integration
- Operate independently on each participating SharedRail federation node.
- Integrate with node-level transaction processing and authorization services.
- Retrieve relevant local reputation, liquidity, and compliance signals.
- Evaluate available federation trust indicators.
- Support authenticated node-to-node communications.
- Exchange permitted transaction verification statuses and risk indicators.
- Allow each node to maintain independent verification policies.
- Support federation-wide compatibility standards without requiring centralized decision-making.
- Provide configurable integration with external financial services.
- Support node discovery and capability negotiation.
- Maintain node-specific model, policy, and verification configurations.
- Continue local verification operations during temporary federation connectivity interruptions.
- Reconcile eligible transaction states when connectivity is restored.
- Prevent external federation signals from overriding mandatory local authorization requirements.
Privacy and Data Protection
- Keep transaction analysis and interactive verification processes on the originating federation node.
- Avoid centralized collection of individual transaction behavior.
- Minimize personally identifiable information in AI processing.
- Prevent private confirmation responses from being distributed across federation nodes by default.
- Separate user identity information from transaction verification metadata where practical.
- Encrypt sensitive local records.
- Support configurable data retention and deletion policies subject to applicable legal obligations.
- Restrict access to transaction and authorization records through role-based permissions.
- Provide privacy-preserving federation signal exchange.
- Prevent AI model training or external telemetry transmission using private transaction information without explicit authorization.
- Provide transparent disclosure of information exchanged with other federation participants.
- Support local privacy and data protection requirements.
Fraud and Social Engineering Detection
- Identify suspicious payment instructions and impersonation attempts.
- Detect urgency-based manipulation and coercive language.
- Identify requests to bypass established approval procedures.
- Detect changes to previously trusted payment destinations.
- Identify suspicious sender and recipient inconsistencies.
- Flag unusual transaction sequences.
- Detect duplicate payment requests and possible replay attempts.
- Identify requests that conflict with established transaction policies.
- Generate contextual warnings explaining identified concerns.
- Escalate suspicious requests for additional verification.
- Maintain configurable fraud detection rules.
- Support human review for designated high-risk transactions.
- Provide mechanisms for reporting suspected fraudulent requests.
Transaction Execution Controls
- Integrate with the node’s authorized transaction execution layer.
- Require successful verification and explicit consent before execution.
- Confirm that transaction details remain unchanged between approval and execution.
- Enforce transaction limits and node-level restrictions.
- Support conditional execution following co-signer approval.
- Support delayed execution and configurable cancellation windows.
- Prevent duplicate execution.
- Reject transactions with expired authorization.
- Maintain transaction state and execution outcomes.
- Record successful, rejected, canceled, and failed transactions.
- Provide execution status notifications.
- Support recovery procedures for interrupted transaction processing.
- Maintain an auditable relationship between the original RFP, verification workflow, signed consent, and final execution result.
Node Administration and Configuration
- Provide administrators with node-level configuration tools.
- Configure AI models, prompt templates, and deterministic logic trees.
- Establish transaction thresholds and risk classification rules.
- Define mandatory confirmation requirements.
- Configure co-signer and multi-party authorization policies.
- Establish jurisdictional restrictions.
- Configure transaction delays and approval expiration periods.
- Manage node-specific cryptographic keys and permissions.
- Monitor verification activity and system health.
- Review policy changes and administrative actions.
- Maintain configuration history and rollback capabilities.
- Provide default security policies with configurable local extensions.
Audit, Monitoring, and Reporting
- Maintain tamper-evident transaction verification histories.
- Record risk classifications and the signals responsible for them.
- Document questions presented to recipients and their confirmation outcomes.
- Record applicable AI model and policy versions.
- Track authorization, rejection, cancellation, and escalation events.
- Provide node-level verification statistics.
- Identify recurring fraud indicators without exposing unnecessary personal information.
- Generate compliance and operational reports.
- Support authorized audit access.
- Provide exportable verification records.
- Monitor AI model performance and false-positive rates.
- Support review of disputed or challenged authorizations.
Developer API and Integration Framework
- Provide documented APIs for federation node integration.
- Support standardized RFP intake and verification interfaces.
- Provide interfaces for AI model configuration and question generation.
- Expose risk evaluation and authorization status endpoints.
- Support signed verification responses.
- Provide event-driven integration with transaction processing systems.
- Support webhooks for verification status changes.
- Provide integration adapters for payment systems and financial applications.
- Maintain API version compatibility.
- Provide developer documentation, examples, and testing utilities.
- Support independently developed plugins and node extensions.
Accessibility and Internationalization
- Provide accessible verification interfaces.
- Support screen readers and keyboard navigation.
- Present transaction information in clear, understandable language.
- Support configurable language preferences.
- Allow localized question templates and risk explanations.
- Support multiple currencies and regional transaction formats.
- Provide accessible alternatives to visual confirmation indicators.
- Ensure translated prompts retain the intended meaning of authorization and consent.
Optional Plugin Modules
Advanced Fraud Intelligence
- Additional fraud detection models.
- Advanced impersonation and social engineering detection.
- Configurable threat intelligence integrations.
- Enhanced transaction anomaly detection.
- Advanced suspicious transaction pattern analysis.
Multi-Party Authorization
- Multiple authorized approvers.
- Threshold-based co-signing.
- Organizational approval hierarchies.
- Escalation and delegation workflows.
- Conditional approval requirements.
Advanced AI Model Support
- Additional locally hosted language models.
- Specialized transaction risk classifiers.
- Model comparison and evaluation tools.
- Custom node-specific prompt libraries.
- Additional language and regional model support.
Compliance Integration
- Configurable jurisdictional compliance rules.
- External compliance service adapters.
- Sanctions and restricted-party screening integrations.
- Compliance reporting and evidence export.
- Configurable regulatory verification workflows.
Advanced Identity Verification
- Optional identity verification integrations.
- Hardware security key support.
- Additional authentication factors.
- Device-bound authorization credentials.
- Enhanced recipient verification workflows.
Federation Reputation Extensions
- Node reputation scoring.
- Historical node reliability indicators.
- Configurable federation trust policies.
- Privacy-preserving risk signal exchange.
- Federation-level trust and integrity assessments.
Financial Institution Integrations
- Banking and payment service adapters.
- Account verification services.
- Payment network integration.
- Transaction status reconciliation.
- External financial transaction monitoring.
Advanced Analytics
- Aggregated node-level risk reporting.
- Verification effectiveness measurements.
- Fraud trend analysis.
- AI model performance comparisons.
- Configurable operational dashboards.
Specification Branding License (SBL)
Standard
- Fully AGPL-3.0+ compliant system
- Copyleft enforced for network deployments
- Required attribution:
- Roxanne Ardary
- https://www.roxanneardary.com/
Optional
- Specification Branding License (SBL)
- Attribution-free commercial deployment
- Pricing based on scale, usage, and deployment scope
- https://roxanneardary.com/trueintent/
License & Notice Requirements
TrueIntent is released under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).
By contributing to any Open Arsenal project, you agree that your contributions will also be released under this license.
Please note the following:
- All contributions must comply with the AGPL-3.0+ terms.
- Under Section 7 of the license, all redistributions, forks, and derivative works must preserve attribution to: Roxanne Ardary and roxanneardary.com.
- TrueIntent specifications are free to use with attribution. A Specification Branding License can be negotiated upon request.
- The project’s notice.md file tracks attribution requirements and contributor acknowledgments. Any update that adds new contributors or modifies attribution should also update
notice.md. - When submitting a pull request, ensure that any new files maintain the attribution headers where applicable.
- Network-deployed versions of this software must also remain fully AGPL-3.0+ compliant, including exposure of source code modifications when applicable under the license.
For full legal details, please refer to the AGPL-3.0+ license and the project’s notice.md file.
Notice – TrueIntent
Attribution Requirement: Under Section 7 of the AGPL 3.0+ license, all redistributions, forks, and derivative works, including network-deployed versions of this project, must provide attribution to Roxanne Ardary and roxanneardary.com.
Contributors
This file tracks contributors and their specific contributions to the project.
- Roxanne Ardary, roxanneardary.com – November 20, 2026
Created the repository for TrueIntent. Developed the project concept and specification for an open-source, AI-powered transaction verification system featuring federation-hosted risk assessment, interactive user confirmation, fraud detection, cryptographic authorization records, and decentralized transaction controls. - Add other contributors here – [Date]
[Describe contribution in one sentence]
License – TrueIntent
This repository is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).
Key Points:
- You are free to use, modify, and distribute the code.
- All redistributions, forks, and derivative works or network-deployed versions must also be licensed under AGPL-3.0+ and provide attribution to Roxanne Ardary and roxanneardary.com as required under Section 7 of the license.
- The software is provided “as is,” without warranty of any kind.
For the full license text, see GNU AGPL-3.0 License.



