Skip to content

Commit e64da9c

Browse files
committed
Release: v1.0.0
1 parent 4016878 commit e64da9c

File tree

6 files changed

+164
-270
lines changed

6 files changed

+164
-270
lines changed

LICENSE

Lines changed: 0 additions & 201 deletions
This file was deleted.

LICENSE-APACHE

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
2+
3+
http://www.apache.org/licenses/LICENSE-2.0
4+
5+
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

LICENSE-MIT

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
The MIT License (MIT)
2+
3+
Permission is hereby granted, free of charge, to any person obtaining a copy
4+
of this software and associated documentation files (the "Software"), to deal
5+
in the Software without restriction, including without limitation the rights
6+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
7+
copies of the Software, and to permit persons to whom the Software is
8+
furnished to do so, subject to the following conditions:
9+
10+
The above copyright notice and this permission notice shall be included in
11+
all copies or substantial portions of the Software.
12+
13+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
14+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
15+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
16+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
17+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
18+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
19+
THE SOFTWARE.

README.md

Lines changed: 36 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,30 @@
11
# Filecoin Solidity
22

3-
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
4-
[![GithubActions](https://github.com/Zondax/filecoin-solidity/actions/workflows/main.yaml/badge.svg)](https://github.com/Zondax/filecoin-solidity/blob/master/.github/workflows/main.yaml)
5-
63
---
74

8-
![zondax_light](docs/assets/zondax_light.png#gh-light-mode-only)
9-
![zondax_dark](docs/assets/zondax_dark.png#gh-dark-mode-only)
5+
[Protocol Labs](https://protocol.ai/) are now the owners of this library, and will mantain it moving forward.
106

11-
_Please visit our website at [zondax.ch](https://www.zondax.ch)_
7+
Originally authored by [Zondax](https://www.zondax.ch).
128

139
---
1410

1511
## Notice
1612

17-
This is software is available under Apache 2.0 License. Use of this library implies your acceptance of these terms and conditions
18-
This source code at this commit hash (https://github.com/Zondax/filecoin-solidity/commit/d6f20ea11b25e66b9a4fb94d0bb0d913edeb5873) was security-reviewed by Kudelski security (Not fully audited)
13+
This software is dual-licensed under the [MIT License](./LICENSE-MIT) and the [Apache Software License v2](./LICENSE-APACHE) by way of the [Permissive License Stack](https://protocol.ai/blog/announcing-the-permissive-license-stack/). Use of this library implies your acceptance of these terms and conditions.
1914

2015
Things to keep in mind, while using this library:
21-
- There are implicit invariants these contracts expect to hold.
22-
- You should exhaustively read each contract you plan to use, top to bottom.
23-
- **You can easily “shoot yourself in the foot” if you’re not careful with how you use the library.**
16+
17+
- There are implicit invariants these contracts expect to hold.
18+
- You should exhaustively read each contract you plan to use, top to bottom.
19+
- **You can easily “shoot yourself in the foot” if you’re not careful with how you use the library.**
2420

2521
---
2622

2723
## Disclaimer :warning:
2824

29-
The libraries have been developed under the following set of assumptions. Take a look at them [here :link:](https://docs.zondax.ch/fevm/filecoin-solidity/introduction/assumptions)
25+
The libraries have been developed under the following set of assumptions.
3026

27+
Take a look at them [here](https://docs.zondax.ch/fevm/filecoin-solidity/introduction/assumptions).
3128

3229
---
3330

@@ -73,26 +70,39 @@ You will need to copy these files to a folder inside your project. Let's name it
7370
import { MarketAPI } from "./libs/MarketAPI.sol";
7471
import { CommonTypes } from "./libs/types/CommonTypes.sol";
7572
import { MarketTypes } from "./libs/types/MarketTypes.sol";
76-
7773
```
7874

7975
#### NPM Package
8076

81-
A better approach to import these libs is using the NPM package created for this. [:link:](https://www.npmjs.com/package/@zondax/filecoin-solidity).
82-
Run on your project in order to add this package.
77+
Better approach to import these libs is using the [NPM package](https://www.npmjs.com/package/filecoin-solidity) created for this .
78+
79+
```
80+
$ npm install filecoin-solidity
81+
```
82+
83+
#### Foundry (git)
84+
85+
> [!WARNING]
86+
> When installing via git, it is a common error to use the `master` branch. This is a development branch that should be avoided in favor of tagged releases. The release process involves security measures that the `master` branch does not guarantee.
8387
84-
```yarn
85-
yarn add @zondax/filecoin-solidity
88+
> [!WARNING]
89+
> Foundry installs the latest version initially, but subsequent `forge update` commands will use the `master` branch.
90+
91+
```
92+
$ forge install filecoin-solidity
8693
```
8794

95+
Add `filecoin-solidity/=lib/filecoin-solidity/` in `remappings.txt.`
96+
97+
#### Usage
98+
8899
In your smart contract, copy and paste these lines.
89100

90101
```solidity
91-
import { MarketAPI } from "@zondax/filecoin-solidity/contracts/v0.8/MarketAPI.sol";
92-
import { CommonTypes } from "@zondax/filecoin-solidity/contracts/v0.8/types/CommonTypes.sol";
93-
import { MarketTypes } from "@zondax/filecoin-solidity/contracts/v0.8/types/MarketTypes.sol";
94-
import { BigInt } from "@zondax/filecoin-solidity/contracts/v0.8/cbor/BigIntCbor.sol";
95-
102+
import { MarketAPI } from "filecoin-solidity/contracts/v0.8/MarketAPI.sol";
103+
import { CommonTypes } from "filecoin-solidity/contracts/v0.8/types/CommonTypes.sol";
104+
import { MarketTypes } from "filecoin-solidity/contracts/v0.8/types/MarketTypes.sol";
105+
import { BigInt } from "filecoin-solidity/contracts/v0.8/cbor/BigIntCbor.sol";
96106
```
97107

98108
## Complementary lectures
@@ -113,13 +123,10 @@ If you’re starting totally new, we got you! Here’s a 101 conceptual read on
113123

114124
Find nice articles with rich and valuable content about different topics related to Filecoin network.
115125

116-
## Looking for a JS library to interact with Filecoin? :wrench::hammer:
126+
## Looking for the complete documentation? :books::books:
117127

118-
We have been working hard to create a complete library that covers every aspect you may need in order to interact with
119-
the Filecoin blockchain. [Let's go to library](https://www.npmjs.com/package/@zondax/izari-filecoin) :arrow_upper_right:
128+
Filecoin solidity documentation: [Let's go to docs web](https://docs.filecoin.io/smart-contracts/developing-contracts/solidity-libraries/) :arrow_upper_right:
120129

121-
## Looking for the complete documentation? :books::books:
130+
---
122131

123-
We have built this beautiful website for you!
124-
[Let's go to docs web](https://docs.zondax.ch/fevm/filecoin-solidity) :arrow_upper_right:
125-
132+
_**Information for `filecoin-solidity` lib developers is contained in [./lib-dev](./lib-dev)**_

0 commit comments

Comments
 (0)