[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBTJWND0PAA76GD9N968VS":3,"skill-same:01M6CBTJWND0PAA76GD9N968VS":47},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":22,"linkOnly":23,"markdownContent":24,"markdownBody":24,"frontMatter":25,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":13,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M6CBTJWND0PAA76GD9N968VS","73-network-http-rpc-client",null,"devwinsoft\u002Fdevian","devwinsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F22570160?v=4","01M6C6RR8W05NH8NPKQNCE3Q72","maoshy","01M6C6RRDJ5TJJCZXRTY801YDH",0,"MIT","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F10-module\u002F60-net\u002F73-network-http-rpc-client\u002FSKILL.md",[],[18,19,20,21],"http","rpc","network","73 network http rpc client","2026-11-10 10:12:30",false,"# 73-network-http-rpc-client\n\nStatus: ACTIVE  \nAppliesTo: v10  \nType: Policy \u002F Requirements\n\n---\n\n## Purpose\n\nDevian 런타임 모듈(단일 모듈)의 Network 기능에 **binary→base64 단일 파라미터 POST RPC 클라이언트**를 추가한다.\n\n이 SKILL은 정책\u002F요구사항\u002F설계 의도를 정의한다. 구현 및 공개 API는 코드가 정답이며, 예시는 참고용이다.\n\n> **Namespace 정책:** 모든 타입은 `namespace Devian` 단일을 사용한다.\n> 네트워크 계열 public API는 `Net` 접두사로 명확화한다.\n\n---\n\n## Scope\n\n### 목표 (In Scope)\n\n- `NetHttpRpcClient`: sync API HTTP RPC 클라이언트\n- base64 single-param POST RPC 규약\n- `application\u002Fx-www-form-urlencoded` 전송\n\n### 비목표 (Out of Scope)\n\n- REST 규격 지원 X\n- TypeScript 변경 X\n- WebSocket과의 통합\u002F공유 큐는 다음 단계\n- JSON 응답 파싱 (기본 미지원)\n\n---\n\n## Module Structure\n\n> Devian C# 런타임은 단일 모듈(`Devian.csproj`)로 통합되어 있다.\n> **모든 타입은 `namespace Devian`에 위치한다.** (분리된 하위 네임스페이스 금지)\n\n```\nframework-cs\u002Fmodule\u002FDevian\u002F\n└── src\u002F\n    └── Net\u002F\n        └── Transports\u002F\n            └── NetHttpRpcClient.cs\n```\n\n---\n\n## RPC Wire Protocol\n\n### Request\n\n| 항목 | 값 |\n|------|-----|\n| Method | `POST` |\n| Content-Type | `application\u002Fx-www-form-urlencoded; charset=utf-8` |\n| Body | `{paramName}={urlEncoded(base64(requestBinary))}` |\n| Default paramName | `\"p\"` |\n\n**Flow:**\n```\nrequestBinary (byte[])\n    ↓ Convert.ToBase64String()\nbase64 string\n    ↓ Uri.EscapeDataString()\nurlEncoded string\n    ↓ \"{paramName}={value}\"\nform-urlencoded body\n```\n\n### Response\n\n| 항목 | 값 |\n|------|-----|\n| Expected | Plain text base64 (no JSON wrapper) |\n| Decoding | `Convert.FromBase64String(text.Trim())` |\n\n**Flow:**\n```\nHTTP Response Body (text)\n    ↓ Trim()\ntrimmed base64 string\n    ↓ Convert.FromBase64String()\nresponseBinary (byte[])\n```\n\n> **Note:** JSON 응답 `{\"p\":\"...\"}` 형태는 기본 미지원. 필요시 옵션 확장 가능.\n\n---\n\n## API Signatures (Reference)\n\n> **Note:** 아래는 이해를 돕기 위한 참고 예시이며, 최종 시그니처\u002F공개 API는 코드가 정답이다.  \n> 코드 변경 시 이 문서를 'SSOT'로 맞추지 않는다. 필요하면 문서를 참고 수준으로 갱신한다.\n\n```csharp\nnamespace Devian\n{\n    \u002F\u002F\u002F \u003Csummary>\n    \u002F\u002F\u002F HTTP RPC client with binary→base64 single-param POST protocol.\n    \u002F\u002F\u002F All public APIs are synchronous.\n    \u002F\u002F\u002F \u003C\u002Fsummary>\n    public sealed class NetHttpRpcClient : IDisposable\n    {\n        \u002F\u002F\u002F \u003Csummary>\n        \u002F\u002F\u002F Creates a new NetHttpRpcClient.\n        \u002F\u002F\u002F \u003C\u002Fsummary>\n        \u002F\u002F\u002F \u003Cparam name=\"endpoint\">RPC endpoint URI.\u003C\u002Fparam>\n        \u002F\u002F\u002F \u003Cparam name=\"paramName\">Form parameter name (default: \"p\").\u003C\u002Fparam>\n        \u002F\u002F\u002F \u003Cparam name=\"http\">Optional HttpClient (if null, creates internal one).\u003C\u002Fparam>\n        public NetHttpRpcClient(Uri endpoint, string paramName = \"p\", HttpClient? http = null);\n\n        \u002F\u002F\u002F \u003Csummary>\n        \u002F\u002F\u002F Synchronously call the RPC endpoint.\n        \u002F\u002F\u002F Throws on HTTP error or decode failure.\n        \u002F\u002F\u002F \u003C\u002Fsummary>\n        \u002F\u002F\u002F \u003Cparam name=\"requestBinary\">Request payload.\u003C\u002Fparam>\n        \u002F\u002F\u002F \u003Creturns>Response payload (decoded from base64).\u003C\u002Freturns>\n        public byte[] Call(ReadOnlySpan\u003Cbyte> requestBinary);\n\n        \u002F\u002F\u002F \u003Csummary>\n        \u002F\u002F\u002F Try to call the RPC endpoint without throwing.\n        \u002F\u002F\u002F \u003C\u002Fsummary>\n        \u002F\u002F\u002F \u003Cparam name=\"requestBinary\">Request payload.\u003C\u002Fparam>\n        \u002F\u002F\u002F \u003Cparam name=\"responseBinary\">Response payload if successful.\u003C\u002Fparam>\n        \u002F\u002F\u002F \u003Creturns>True if successful, false otherwise.\u003C\u002Freturns>\n        public bool TryCall(ReadOnlySpan\u003Cbyte> requestBinary, out byte[] responseBinary);\n\n        \u002F\u002F\u002F \u003Csummary>\n        \u002F\u002F\u002F Dispose the client (releases HttpClient if owned).\n        \u002F\u002F\u002F \u003C\u002Fsummary>\n        public void Dispose();\n    }\n}\n```\n\n---\n\n## Hard Rules\n\n### MUST\n\n1. **Public API는 sync만 제공**: `Call()`, `TryCall()`, `Dispose()`\n2. **async 노출 금지**: `Task`, `ValueTask`, `async` 키워드 금지 (public API)\n3. **내부에서만 async 사용**: `SendAsync(...).GetAwaiter().GetResult()` 패턴\n4. **HttpClient 주입 지원**: 외부 주입 시 Dispose하지 않음\n\n### MUST NOT\n\n1. public API에 `async` 도입\n2. REST 규격이나 JSON 파싱 기본 구현\n3. WebSocket 코드와 결합\n\n---\n\n## Error Policy\n\n| 메서드 | 실패 시 |\n|--------|---------|\n| `Call()` | 예외 throw (`HttpRequestException`, `FormatException` 등) |\n| `TryCall()` | `false` 반환, `responseBinary = Array.Empty\u003Cbyte>()` |\n\n---\n\n## Usage Example\n\n```csharp\nusing Devian;\n\n\u002F\u002F Create client\nusing var rpc = new NetHttpRpcClient(new Uri(\"https:\u002F\u002Fapi.example.com\u002Frpc\"));\n\n\u002F\u002F Prepare request\nbyte[] request = \u002F* serialized protobuf or other binary *\u002F;\n\n\u002F\u002F Call (throws on error)\nbyte[] response = rpc.Call(request);\n\n\u002F\u002F Or try-call (no throw)\nif (rpc.TryCall(request, out var resp))\n{\n    \u002F\u002F handle resp\n}\n```\n\n---\n\n## Build Target\n\n- `netstandard2.1` 유지\n- 추가 NuGet 패키지 불필요 (`System.Net.Http`는 기본 포함)\n\n---\n\n## Reference\n\n- Parent Module: `Devian` (단일 런타임 모듈, `namespace Devian`)\n- Related: `skills\u002Fdevian\u002F10-module\u002F60-net\u002F72-network-ws-client\u002FSKILL.md`\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian\u002F10-module\u002F60-net\u002F73-network-http-rpc-client","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft","Kim Hyong Joon","2026-04-12 18:44:10",{"source":7,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add devwinsoft\u002Fdevian --skill 73-network-http-rpc-client",{"tool":39,"command":40},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 73-network-http-rpc-client",{"tool":42,"command":43},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 73-network-http-rpc-client","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F10-module\u002F60-net\u002F73-network-http-rpc-client\u002FSKILL.md",true,[],[48,54,62,70,79,86],{"skillNo":49,"name":50,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":22},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[50],{"skillNo":55,"name":56,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":22},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[60,61],"archive","90 project archive",{"skillNo":63,"name":64,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":22},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[68,69],"management","30 env management",{"skillNo":71,"name":72,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":22},"01M6CBWYD3TGWBQV7V35551THF","19-page-push-send","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F19-page-push-send\u002FSKILL.md",[],[76,77,78],"push","page","19 page push send",{"skillNo":80,"name":81,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":22},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[77,85],"18 page savedata",{"skillNo":87,"name":88,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":22},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[77,92],"17 page deobfuscate"]