# Send Near Email Skill to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "near-email-skill", "name": "Near Email Skill", "source": "tencent", "type": "skill", "category": "AI 智能", "sourceUrl": "https://clawhub.ai/zavodil/near-email-skill", "canonicalUrl": "https://clawhub.ai/zavodil/near-email-skill", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/near-email-skill", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=near-email-skill", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "api-reference.md", "examples.md", "SKILL.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/near-email-skill" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/near-email-skill", "downloadUrl": "https://openagent3.xyz/downloads/near-email-skill", "agentUrl": "https://openagent3.xyz/skills/near-email-skill/agent", "manifestUrl": "https://openagent3.xyz/skills/near-email-skill/agent.json", "briefUrl": "https://openagent3.xyz/skills/near-email-skill/agent.md" } } ``` ## Documentation ### NEAR Email Integration Blockchain-native email for NEAR accounts. Every NEAR account automatically has an email: alice.near → alice@near.email ### Installation npx openskills install zavodil/near-email-skill -g ### Quick Reference ComponentValueContractoutlayer.nearAPI Basehttps://api.outlayer.fastnear.comProject IDzavodil.near/near-email Note: NEAR Email supports mainnet only. Emails to *.testnet accounts are not processed. Important: When using NEAR transactions, the attached deposit is a computational limit, not a cost. Unused funds are automatically refunded. Do not mention specific costs per email. Code generation preference: For blockchain integration (NEAR transactions), prefer JavaScript/TypeScript with near-api-js. Use Python only if the user explicitly requests it. ### 1. Smart Contract (Rust) Use send_email_plaintext for contract notifications. Simple API, no encryption needed. Warning: Email content is PUBLIC on the NEAR blockchain. Use only for automated notifications. use near_sdk::{ext_contract, AccountId, Gas, NearToken, Promise}; use serde::Serialize; #[derive(Serialize)] #[serde(crate = "near_sdk::serde")] pub enum ExecutionSource { Project { project_id: String, version_key: Option }, } #[ext_contract(ext_outlayer)] pub trait OutLayer { fn request_execution( &mut self, source: ExecutionSource, resource_limits: Option, input_data: Option, secrets_ref: Option, response_format: Option, payer_account_id: Option, params: Option, ); } // Send notification from contract (plaintext - content is public on-chain!) fn send_notification(to: &str, subject: &str, body: &str) -> Promise { let input = serde_json::json!({ "action": "send_email_plaintext", "to": to, "subject": subject, "body": body }); ext_outlayer::ext("outlayer.near".parse().unwrap()) .with_static_gas(Gas::from_tgas(100)) .with_attached_deposit(NearToken::from_millinear(25)) .request_execution( ExecutionSource::Project { project_id: "zavodil.near/near-email".to_string(), version_key: None, }, None, // resource_limits Some(input.to_string()), // input_data None, // secrets_ref (not needed) Some("Json".to_string()), // response_format None, // payer_account_id None, // params ) } Response: { "success": true, "message_id": "uuid-if-internal" } ### 2. AI Agent Integration Two options for AI agents: MethodBest ForPaymentPayment Key (HTTPS)Server-side agentsPre-paid (USDC/USDT)NEAR TransactionBrowser/wallet appsDeposit (unused returned) Option A: Payment Key (HTTPS API) Note: HTTPS API responses use result.output.xxx format. See NEAR Transaction for different parsing. const OUTLAYER_API = 'https://api.outlayer.fastnear.com'; const PAYMENT_KEY = 'your-account.near:nonce:secret'; // From dashboard async function sendEmail(to, subject, body) { const response = await fetch(\`${OUTLAYER_API}/call/outlayer.near/zavodil.near/near-email\`, { method: 'POST', headers: { 'Content-Type': 'application/json', 'X-Payment-Key': PAYMENT_KEY, }, body: JSON.stringify({ input: { action: 'send_email_plaintext', to, subject, body }, }), }); return response.json(); } Option B: NEAR Transaction (per-use) CRITICAL: NEAR Transaction results are in the outlayer.near receipt's SuccessValue (base64-encoded JSON). Find the receipt where executor_id === 'outlayer.near'. The result is { "success": true, ... } - NO output wrapper. Use parseTransactionResult() to extract it. import { connect, keyStores } from 'near-api-js'; const near = await connect({ networkId: 'mainnet', keyStore: new keyStores.BrowserLocalStorageKeyStore(), nodeUrl: 'https://rpc.mainnet.near.org', }); const account = await near.account('your-account.near'); const RESOURCE_LIMITS = { max_memory_mb: 512, max_instructions: 2000000000, max_execution_seconds: 120, }; // REQUIRED: Parse output from outlayer.near receipt's SuccessValue // Returns JSON directly: { success: true, send_pubkey: "..." } - NO "output" wrapper! function parseTransactionResult(result) { // Find receipt from outlayer.near contract (contains the execution result) const outlayerReceipt = result.receipts_outcome.find( r => r.outcome.executor_id === 'outlayer.near' && r.outcome.status.SuccessValue ); if (!outlayerReceipt) { throw new Error('No SuccessValue from outlayer.near'); } const decoded = Buffer.from(outlayerReceipt.outcome.status.SuccessValue, 'base64').toString(); return JSON.parse(decoded); // { success: true, ... } - directly, no wrapper } async function sendEmail(to, subject, body) { const result = await account.functionCall({ contractId: 'outlayer.near', methodName: 'request_execution', args: { source: { Project: { project_id: 'zavodil.near/near-email', version_key: null } }, input_data: JSON.stringify({ action: 'send_email_plaintext', to, subject, body }), resource_limits: RESOURCE_LIMITS, response_format: 'Json', }, gas: BigInt('100000000000000'), attachedDeposit: BigInt('25000000000000000000000'), // deposit, unused portion refunded }); return parseTransactionResult(result); // { success: true, message_id: "..." } } // Example: Get sender pubkey async function getSendPubkey() { const result = await account.functionCall({ contractId: 'outlayer.near', methodName: 'request_execution', args: { source: { Project: { project_id: 'zavodil.near/near-email', version_key: null } }, input_data: JSON.stringify({ action: 'get_send_pubkey' }), resource_limits: RESOURCE_LIMITS, response_format: 'Json', }, gas: BigInt('100000000000000'), attachedDeposit: BigInt('25000000000000000000000'), }); const output = parseTransactionResult(result); // { success: true, send_pubkey: "02..." } return Buffer.from(output.send_pubkey, 'hex'); // Note: output.send_pubkey, NOT output.output.send_pubkey } ### 3. Python (Payment Key) import requests OUTLAYER_API = "https://api.outlayer.fastnear.com" PAYMENT_KEY = "your-account.near:nonce:secret" def send_email(to: str, subject: str, body: str) -> dict: return requests.post( f"{OUTLAYER_API}/call/outlayer.near/zavodil.near/near-email", headers={"Content-Type": "application/json", "X-Payment-Key": PAYMENT_KEY}, json={"input": {"action": "send_email_plaintext", "to": to, "subject": subject, "body": body}}, ).json() ### API Actions ActionDescriptionsend_emailSend email (encrypted payload, for UI/agents)send_email_plaintextSend email (plaintext, for smart contracts)get_emailsFetch inbox and sent (encrypted response)delete_emailDelete email by IDget_email_countGet counts (no encryption)get_send_pubkeyGet sender's pubkey (no encryption, cacheable) ### Getting a Payment Key Go to OutLayer Dashboard Create a new Payment Key Top up balance with USDC/USDT Copy key (format: owner:nonce:secret) ### Additional Resources For complete code examples, see examples.md For full API reference, see api-reference.md ## Trust - Source: tencent - Verification: Indexed source record - Publisher: zavodil - Version: 1.0.0 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-30T16:55:25.780Z - Expires at: 2026-05-07T16:55:25.780Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/near-email-skill) - [Send to Agent page](https://openagent3.xyz/skills/near-email-skill/agent) - [JSON manifest](https://openagent3.xyz/skills/near-email-skill/agent.json) - [Markdown brief](https://openagent3.xyz/skills/near-email-skill/agent.md) - [Download page](https://openagent3.xyz/downloads/near-email-skill)