Skip to content

Commit

Permalink
fix: fix README
Browse files Browse the repository at this point in the history
  • Loading branch information
zensh committed Jul 4, 2024
1 parent 249bfe1 commit 2623261
Show file tree
Hide file tree
Showing 8 changed files with 19 additions and 26 deletions.
2 changes: 1 addition & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ node_modules/

# Remove Cargo.lock from gitignore if creating an executable, leave it for libraries
# More information here https://doc.rust-lang.org/cargo/guide/cargo-toml-vs-cargo-lock.html
# Cargo.lock
Cargo.lock

# These are backup files generated by rustfmt
**/*.rs.bk
Expand Down
4 changes: 2 additions & 2 deletions Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ members = [
resolver = "2"

[workspace.package]
version = "0.5.2"
version = "0.5.4"
edition = "2021"
repository = "https://github.com/ldclabs/idempotent-proxy"
keywords = ["idempotent", "reverse", "proxy", "icp"]
Expand Down
11 changes: 9 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,6 @@

💝 This project received a **$5k Developer Grant** from the Dfinity Foundation.

See: https://forum.dfinity.org/t/idempotent-proxy-proxy-https-outcalls-to-any-web2-service/30624

## Overview

The idempotent-proxy is a reverse proxy service written in Rust with built-in idempotency support.
Expand All @@ -15,6 +13,15 @@ This service can be used to proxy [HTTPS outcalls](https://internetcomputer.org/

![Idempotent Proxy](./idempotent-proxy.png)

## Packages

| Package | Description |
| :----------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------ |
| [idempotent-proxy-server](https://github.com/ldclabs/idempotent-proxy/tree/main/src/idempotent-proxy-server) | Idempotent Proxy implemented in Rust. |
| [idempotent-proxy-cf-worker](https://github.com/ldclabs/idempotent-proxy/tree/main/src/idempotent-proxy-cf-worker) | Idempotent Proxy implemented as Cloudflare Worker. |
| [idempotent-proxy-types](https://github.com/ldclabs/idempotent-proxy/tree/main/src/idempotent-proxy-types) | Idempotent Proxy types in Rust. Should not be used in ICP canister! |
| [examples/eth-canister](https://github.com/ldclabs/idempotent-proxy/tree/main/examples/eth-canister) | A ICP canister integration with Ethereum JSON-RPC API. |

## Features
- [x] Reverse proxy with build-in idempotency support
- [x] JSON response filtering
Expand Down
2 changes: 1 addition & 1 deletion examples/eth-canister/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,4 +53,4 @@ dfx canister call eth-canister get_best_block '()'
## License
Copyright © 2024 [LDC Labs](https://github.com/ldclabs).

`ldclabs/idempotent-proxy` is licensed under the MIT License. See [LICENSE](LICENSE-MIT) for the full license text.
`ldclabs/idempotent-proxy` is licensed under the MIT License. See [LICENSE](../../LICENSE-MIT) for the full license text.
4 changes: 1 addition & 3 deletions src/idempotent-proxy-cf-worker/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,8 +11,6 @@ This service can be used to proxy [HTTPS outcalls](https://internetcomputer.org/

![Idempotent Proxy](./idempotent-proxy.png)

If you plan to use this project and have any questions, feel free to open an issue. I will address it as soon as possible.

## Run proxy in local development mode

Run proxy:
Expand Down Expand Up @@ -47,4 +45,4 @@ More information: https://github.com/ldclabs/idempotent-proxy
## License
Copyright © 2024 [LDC Labs](https://github.com/ldclabs).

`ldclabs/idempotent-proxy` is licensed under the MIT License. See [LICENSE](LICENSE-MIT) for the full license text.
`ldclabs/idempotent-proxy` is licensed under the MIT License. See [LICENSE](../../LICENSE-MIT) for the full license text.
16 changes: 2 additions & 14 deletions src/idempotent-proxy-server/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,7 @@ When multiple requests with the same idempotency-key arrive within a specific ti

This service can be used to proxy [HTTPS outcalls](https://internetcomputer.org/docs/current/developer-docs/smart-contracts/advanced-features/https-outcalls/https-outcalls-overview) for [ICP canisters](https://internetcomputer.org/docs/current/developer-docs/smart-contracts/overview/introduction), enabling integration with any Web2 http service. It supports hiding secret information, access control, returning only the necessary headers and, for JSON or CBOR data, allows response filtering based on JSON Mask to return only required fields, thus saving cycles consumption in ICP canisters.

![Idempotent Proxy](./idempotent-proxy.png)

If you plan to use this project and have any questions, feel free to open an issue. I will address it as soon as possible.
![Idempotent Proxy](../../idempotent-proxy.png)

## Features
- [x] Reverse proxy with build-in idempotency support
Expand All @@ -32,17 +30,7 @@ docker run --name redis -d -p 6379:6379 redis:latest
cargo run -p idempotent-proxy-server
```

### Run proxy with Docker

Run proxy with Docker:
```bash
docker run --name redis -d -p 6379:6379 redis:latest
docker run --name idempotent-proxy -d -p 8080:8080 --link redis:redis zensh/idempotent-proxy
```

More information: https://github.com/ldclabs/idempotent-proxy

## License
Copyright © 2024 [LDC Labs](https://github.com/ldclabs).

`ldclabs/idempotent-proxy` is licensed under the MIT License. See [LICENSE](LICENSE-MIT) for the full license text.
`ldclabs/idempotent-proxy` is licensed under the MIT License. See [LICENSE](../../LICENSE-MIT) for the full license text.
4 changes: 2 additions & 2 deletions src/idempotent-proxy-types/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ When multiple requests with the same idempotency-key arrive within a specific ti

This service can be used to proxy [HTTPS outcalls](https://internetcomputer.org/docs/current/developer-docs/smart-contracts/advanced-features/https-outcalls/https-outcalls-overview) for [ICP canisters](https://internetcomputer.org/docs/current/developer-docs/smart-contracts/overview/introduction), enabling integration with any Web2 http service. It supports hiding secret information, access control, returning only the necessary headers and, for JSON or CBOR data, allows response filtering based on JSON Mask to return only required fields, thus saving cycles consumption in ICP canisters.

![Idempotent Proxy](./idempotent-proxy.png)
![Idempotent Proxy](../../idempotent-proxy.png)

## Features
- [x] Reverse proxy with build-in idempotency support
Expand All @@ -25,4 +25,4 @@ More information: https://github.com/ldclabs/idempotent-proxy
## License
Copyright © 2024 [LDC Labs](https://github.com/ldclabs).

`ldclabs/idempotent-proxy` is licensed under the MIT License. See [LICENSE](LICENSE-MIT) for the full license text.
`ldclabs/idempotent-proxy` is licensed under the MIT License. See [LICENSE](../../LICENSE-MIT) for the full license text.

0 comments on commit 2623261

Please sign in to comment.