=== Heavenkey – Digital Will Web3 ===
Contributors: fra301076, francescoventura
Tags: digital-will, web3, metamask, eip712, blockchain
Requires at least: 5.8
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0.3
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Text Domain: heavenkey-digital-will-web3

== Description ==

Sign and secure your digital will using Web3 wallets. EIP-712 signature, no server storage, 100% client-side privacy.

**Heavenkey** is the first WordPress plugin that allows users to write and off-chain sign a digital will — directly from your website, no coding required.

== How it works ==

1. Add the `[heavenkey_form]` shortcode to any page or post.  
2. Visitors connect their Web3 wallet (MetaMask, Ledger, WalletConnect, etc.).  
3. They enter their name, a beneficiary wallet address, and a personal message.  
4. Clicking **Sign with Wallet** signs the data using EIP-712 (gas-less) directly in the browser.  
5. The result is a tamper-proof signed JSON including wallet address, timestamp, message, and signature.

Key features:
* **100% client-side** – no server storage.
* **Privacy by design** – all data stays in the browser.
* **Secure by default** – EIP-712 signature for proof of authorship.
* **Translation-ready** – `.pot` template included.
* **Theme-compatible** – works with any theme or builder.
* **Blockchain-neutral** – supports Ethereum, Polygon, Arbitrum, BNB, Base, and other EVM chains.

> *Disclaimer:* Heavenkey is *not* a legal replacement for an official notarial will. It provides cryptographic proof of intent. Consult local regulations for legal validity.

== Who Can Use Heavenkey? ==

* 👨‍👩‍👧‍👦 **Private individuals & families** – create a personal digital will or message for loved ones.  
* 🧑‍⚖️ **Lawyers & legal-tech consultants** – offer a digital pre-declaration tool to clients.  
* 🎨 **Artists & creators** – sign a statement regarding future use of their work or profiles.  
* 🏛️ **DAO members & multisig signers** – publish exit intents or succession signals.  
* 🪙 **Crypto holders & DeFi users** – leave instructions about wallets or fund distribution.  
* 💼 **Start-ups & fintech founders** – time-proof signed intents (e.g. on IPFS).  

== Security & Privacy ==

All signing occurs entirely in the user’s browser. No private key, seed phrase, or sensitive data is stored or transmitted.

== Signature Verification ==

Signed JSON files can be verified using:
- ✅ The official browser-based tool: https://www.francescoventura.it/heavenkey/  
- 📦 GitHub source and verification: https://github.com/fra301076/heavenkey-digital-will-web3/releases/tag/v1.0.3

Heavenkey uses EIP-712 for verifiable, tamper-proof signatures.  
All verification happens client-side with no backend or storage involved.

== Installation ==

1. Upload the `heavenkey-digital-will-web3` folder to `/wp-content/plugins/`.  
2. Activate the plugin from **Plugins → Installed Plugins**.  
3. Insert the shortcode `[heavenkey_form]` into any post or page.  
4. Use the form to create and sign a digital will via Web3 wallet.  
5. Translate using any gettext plugin (e.g. WPML, Loco Translate, Polylang).

== Frequently Asked Questions ==

= Is any data stored on the server? =
No. Everything runs client-side.

= Which wallets are supported? =
MetaMask, Ledger (via MetaMask or WalletConnect), WalletConnect v3, Trezor, Rabby, Safe, and all EVM-compatible wallets.

= Is the EIP-712 signature legally binding? =
It provides strong cryptographic proof of authorship. Consult a qualified professional for jurisdiction-specific enforceability.

= Can I create more than one will? =
Yes. Each signed JSON is a unique declaration.

= Is it compatible with all WordPress themes and builders? =
Yes. The plugin is responsive and works with Gutenberg, Elementor, WPBakery, and all major builders.

= Is the plugin translation-ready? =
Yes. A `.pot` template is included. Compatible with Poedit, Loco Translate, WPML, and Polylang.

= How can I get support? =
Email: info@heavenkey.xyz  
Website: https://www.francescoventura.it/heavenkey/

== Changelog ==

= 1.0.3 =
* Updated `ethers.umd.min.js` to v6.14.4 (latest stable release).
* Removed fallback hardcoded path in `connect-wallet-new.js` for better compatibility.
* Confirmed plugin ownership via `info@heavenkey.xyz`.

= 1.0.2 =
* Updated text domain to match plugin slug: `heavenkey-digital-will-web3`.  
* Fixed localization warnings for WordPress Plugin Directory compliance.  
* Added verification tool and GitHub release reference.

= 1.0.1 =
* Replaced regex with `ethers.isAddress()` for checksum validation.  
* Removed external Google Fonts; added local CSS.  
* Added WP constants and script translation hooks.  
* Updated headers for compliance and PHP requirement.

= 1.0.0 =
* Initial release: JSON output, EIP-712 signature, shortcode, multilingual support, responsive frontend.

== Source Code Notice ==

This plugin uses the [Ethers.js](https://github.com/ethers-io/ethers.js) library, which is open-source under the MIT license.  
You can view the full uncompressed source code here:  
https://github.com/ethers-io/ethers.js

The full source code for this plugin is also available here:  
https://github.com/fra301076/heavenkey-digital-will-web3